agentfootprint 9.111.0 → 9.112.1

package/dist/esm/ontology/fromSkos.js

@@ -0,0 +1,356 @@
+/**
+ * ontology/fromSkos — a customer's SKOS concept scheme (JSON-LD, already
+ * parsed) becomes OUR map: `readSkos` is the pure parse, `fromSkos` joins
+ * the host's sources onto it and returns an `OntologySpec` for
+ * `defineOntology` — the ONE shape everything else reads.
+ *
+ * Pattern: reader = adapter. Two pure functions over plain JSON; no I/O, no
+ *          registry, no second validation path — the result goes through
+ *          `defineOntology` unchanged, which is where an id that is not
+ *          identifier-safe, an alias that collides with an id, or a source
+ *          nobody declared is refused.
+ * Role:    Map. Nothing here infers: a concept is a node typed
+ *          `skos:Concept`, its id is the last segment of its IRI, its
+ *          meaning is its `definition`, else its `scopeNote`, else its
+ *          `prefLabel`; `broader` is `is-a`, `related` is `related`; every
+ *          other name and every label in another language is left where it
+ *          was. SKOS cannot say which SOURCE holds a term or which TOOL reads
+ *          it — the host binds those by hand in `SkosJoin.bind`; a term with
+ *          no binding is the honest state "declared, no source holds it".
+ * Emits:   N/A.
+ *
+ * THE OWNER'S RULING (2026-09-18): customers already have taxonomies, almost
+ * always as SKOS. The library takes THEIRS in and turns it into OUR map;
+ * readers are adapters, `defineOntology` stays canonical. OWL is out of
+ * scope; a Turtle reader is a follow-up; serving the map back in SKOS
+ * vocabulary waits for the bench.
+ *
+ * REFUSALS — every one an `Error` with a `code` (`ERR_SKOS_…`), the IRI(s)
+ * involved and what was expected; the reader never returns a partial map:
+ *   ERR_SKOS_INPUT             not a JSON-LD document, or a node that is not an object
+ *   ERR_SKOS_NAMED_GRAPH       a node that is itself a named graph (`{ "@id", "@graph": [...] }`) —
+ *                              its concepts would be dropped without a word; flatten the document first
+ *   ERR_SKOS_UNTYPED           a node carrying SKOS properties with no `@type`
+ *   ERR_SKOS_NO_CONCEPTS       no `skos:Concept` in the document
+ *   ERR_SKOS_NO_LABEL          a concept with no prefLabel in the asked language
+ *   ERR_SKOS_ID                an IRI whose last segment is empty
+ *   ERR_SKOS_ID_COLLISION      two concepts collapsing to one id
+ *   ERR_SKOS_UNKNOWN_CONCEPT   a broader/narrower/related target the document does not hold
+ *   ERR_SKOS_CYCLE             a cycle in `broader` (SKOS forbids it)
+ *   ERR_SKOS_SCHEME_MISSING    no id or no version, from the join or the scheme node
+ *   ERR_SKOS_SCHEME_AMBIGUOUS  several scheme nodes and the join does not settle id and version
+ *   ERR_SKOS_BIND_UNKNOWN_TERM a `bind` key naming a term the scheme does not hold
+ */
+import { expandIri, expandNode, FOOTPRINT, idFromIri, inLanguage, irisOf, isRecord, literalsOf, readContext, SKOS, typesOf, valuesOf, VERSION_IRIS, } from './skosJsonLd.js';
+/** The one error the reader throws: a `code`, the IRI(s) involved, what was expected. */
+export class SkosError extends Error {
+    code;
+    iris;
+    constructor(code, message, iris = []) {
+        super(`${code}: ${message}`);
+        this.name = 'SkosError';
+        this.code = code;
+        this.iris = Object.freeze([...iris]);
+    }
+}
+const DEFAULT_LANGUAGE = 'en';
+const CONCEPT_PROPERTIES = [
+    SKOS.prefLabel,
+    SKOS.altLabel,
+    SKOS.hiddenLabel,
+    SKOS.definition,
+    SKOS.scopeNote,
+    SKOS.broader,
+    SKOS.narrower,
+    SKOS.related,
+    SKOS.inScheme,
+    SKOS.topConceptOf,
+    SKOS.hasTopConcept,
+];
+/** Split the input into its context and its node objects; refuse anything that is not a document. */
+function readDocument(input) {
+    if (Array.isArray(input))
+        return { context: readContext(undefined), nodes: checkNodes(input) };
+    if (!isRecord(input)) {
+        throw new SkosError('ERR_SKOS_INPUT', 'expected a JSON-LD document: an object, an array of node objects, or { "@graph": [...] }.');
+    }
+    const context = readContext(input['@context']);
+    if ('@graph' in input) {
+        if (!Array.isArray(input['@graph'])) {
+            throw new SkosError('ERR_SKOS_INPUT', 'expected "@graph" to be an array of node objects.');
+        }
+        return { context, nodes: checkNodes(input['@graph']) };
+    }
+    const single = Object.fromEntries(Object.entries(input).filter(([key]) => key !== '@context'));
+    return { context, nodes: checkNodes([single]) };
+}
+function checkNodes(raw) {
+    return raw.map((node, i) => {
+        if (!isRecord(node)) {
+            throw new SkosError('ERR_SKOS_INPUT', `node ${i} is not an object; expected a JSON-LD node object.`);
+        }
+        // A named graph nested in the graph: JSON-LD allows it, this reader does not
+        // walk into it — and silently skipping it would hand back a partial map.
+        if ('@graph' in node) {
+            throw new SkosError('ERR_SKOS_NAMED_GRAPH', `node ${i}${typeof node['@id'] === 'string' ? ` ('${node['@id']}')` : ''} is a named graph; expected a flat "@graph" of node objects — flatten the document first.`, typeof node['@id'] === 'string' ? [node['@id']] : []);
+        }
+        return node;
+    });
+}
+/** Sort the nodes by `@type`; a node with SKOS properties and no type is refused, never guessed. */
+function typeNodes(doc) {
+    const concepts = [];
+    const schemes = [];
+    doc.nodes.forEach((node, i) => {
+        const props = expandNode(node, doc.context);
+        const rawId = props.get('@id');
+        const iri = typeof rawId === 'string' ? expandIri(rawId, doc.context) : `_:node${i}`;
+        const types = typesOf(props, doc.context);
+        if (types.includes(SKOS.Concept))
+            concepts.push({ iri, props });
+        else if (types.includes(SKOS.ConceptScheme))
+            schemes.push({ iri, props });
+        else if (types.length === 0 && CONCEPT_PROPERTIES.some((p) => props.has(p))) {
+            throw new SkosError('ERR_SKOS_UNTYPED', `node '${iri}' carries SKOS properties but no @type; expected skos:Concept or skos:ConceptScheme.`, [iri]);
+        }
+    });
+    return { concepts, schemes };
+}
+function readConcept(raw, context, language) {
+    const { iri, props } = raw;
+    const id = idFromIri(iri);
+    if (id.length === 0) {
+        throw new SkosError('ERR_SKOS_ID', `concept '${iri}' has no last path or fragment segment to take an id from.`, [iri]);
+    }
+    const prefLabels = inLanguage(literalsOf(props, SKOS.prefLabel, context), language);
+    if (prefLabels.length === 0) {
+        const seen = literalsOf(props, SKOS.prefLabel, context).map((l) => l.language ?? 'untagged');
+        throw new SkosError('ERR_SKOS_NO_LABEL', `concept '${iri}' has no skos:prefLabel in language '${language}' (labels seen: ${seen.length === 0 ? 'none' : seen.join(', ')}); a label is never taken from another language.`, [iri]);
+    }
+    const prefLabel = prefLabels[0];
+    const meaning = inLanguage(literalsOf(props, SKOS.definition, context), language)[0] ??
+        inLanguage(literalsOf(props, SKOS.scopeNote, context), language)[0] ??
+        prefLabel;
+    const aliases = uniqueNames([
+        ...inLanguage(literalsOf(props, SKOS.altLabel, context), language),
+        ...inLanguage(literalsOf(props, SKOS.hiddenLabel, context), language),
+        ...(prefLabel !== id ? [prefLabel] : []),
+    ]).filter((alias) => alias !== id);
+    const unit = literalsOf(props, FOOTPRINT.unit, context)[0]?.value;
+    return {
+        iri,
+        id,
+        prefLabel,
+        node: {
+            meaning,
+            ...(unit !== undefined && { unit }),
+            ...(aliases.length > 0 && { aliases }),
+        },
+    };
+}
+function uniqueNames(names) {
+    return [...new Set(names.map((n) => n.trim()).filter((n) => n.length > 0))];
+}
+/** Concepts sorted by id, with a collision refused naming both IRIs. */
+function readConcepts(typed, context, language) {
+    if (typed.concepts.length === 0) {
+        throw new SkosError('ERR_SKOS_NO_CONCEPTS', 'the document holds no node typed skos:Concept.');
+    }
+    const byId = new Map();
+    for (const raw of typed.concepts) {
+        const concept = readConcept(raw, context, language);
+        const other = byId.get(concept.id);
+        if (other !== undefined) {
+            throw new SkosError('ERR_SKOS_ID_COLLISION', `concepts '${other.iri}' and '${concept.iri}' both collapse to id '${concept.id}'; expected distinct last segments.`, [other.iri, concept.iri]);
+        }
+        byId.set(concept.id, concept);
+    }
+    return [...byId.values()].sort((a, b) => (a.id < b.id ? -1 : 1));
+}
+// ─── Edges ──────────────────────────────────────────────────────────────
+function readEdges(typed, concepts, context) {
+    const idOf = new Map(typed.concepts.map((c) => [c.iri, idFromIri(c.iri)]));
+    const resolve = (from, property, target) => {
+        const id = idOf.get(target);
+        if (id === undefined) {
+            throw new SkosError('ERR_SKOS_UNKNOWN_CONCEPT', `concept '${from}' has ${property} '${target}', which is not a skos:Concept in this document.`, [from, target]);
+        }
+        return id;
+    };
+    const propsOf = new Map(typed.concepts.map((c) => [c.iri, c.props]));
+    const isA = new Map();
+    const related = new Map();
+    const declared = [];
+    for (const concept of concepts) {
+        const props = propsOf.get(concept.iri) ?? new Map();
+        for (const target of irisOf(props, SKOS.broader, context)) {
+            addOnce(isA, {
+                from: concept.id,
+                to: resolve(concept.iri, 'skos:broader', target),
+                relation: 'is-a',
+            });
+        }
+        for (const target of irisOf(props, SKOS.narrower, context)) {
+            addOnce(isA, {
+                from: resolve(concept.iri, 'skos:narrower', target),
+                to: concept.id,
+                relation: 'is-a',
+            });
+        }
+        for (const target of irisOf(props, SKOS.related, context)) {
+            const other = resolve(concept.iri, 'skos:related', target);
+            const [from, to] = concept.id < other ? [concept.id, other] : [other, concept.id];
+            addOnce(related, { from, to, relation: 'related' });
+        }
+        for (const entry of valuesOf(props, FOOTPRINT.edge)) {
+            if (!isRecord(entry))
+                continue;
+            const edgeProps = expandNode(entry, context);
+            const target = irisOf(edgeProps, FOOTPRINT.to, context)[0];
+            const relation = literalsOf(edgeProps, FOOTPRINT.relation, context)[0]?.value;
+            const meaning = literalsOf(edgeProps, FOOTPRINT.meaning, context)[0]?.value;
+            if (target === undefined || relation === undefined)
+                continue;
+            const edge = {
+                from: concept.id,
+                to: resolve(concept.iri, 'footprint:edge', target),
+                relation,
+                ...(meaning !== undefined && { meaning }),
+            };
+            // `toSkos` writes an `is-a`/`related` edge that carries a meaning BOTH
+            // as the SKOS relation and as a `footprint:edge`: the latter completes
+            // the former (same key, the meaning added) rather than doubling it.
+            const key = edgeKey(edge);
+            if (isA.has(key))
+                isA.set(key, edge);
+            else if (related.has(key))
+                related.set(key, edge);
+            else
+                declared.push(edge);
+        }
+    }
+    // Sorted, so the same scheme written with `narrower` instead of `broader`
+    // (or in another node order) yields the same edges — and the same hash.
+    const edges = [
+        ...sortEdges(isA.values()),
+        ...sortEdges(related.values()),
+        ...sortEdges(declared),
+    ];
+    refuseCycles(concepts, [...isA.values()]);
+    return edges;
+}
+function sortEdges(edges) {
+    return [...edges].sort((a, b) => edgeKey(a).localeCompare(edgeKey(b)));
+}
+function edgeKey(edge) {
+    return `${edge.from} —${edge.relation}→ ${edge.to}`;
+}
+function addOnce(into, edge) {
+    const key = edgeKey(edge);
+    if (!into.has(key))
+        into.set(key, edge);
+}
+/** A cycle in `broader` is refused with the cycle named, id by id. */
+function refuseCycles(concepts, isA) {
+    const broader = new Map();
+    for (const edge of isA)
+        broader.set(edge.from, [...(broader.get(edge.from) ?? []), edge.to]);
+    const done = new Set();
+    const iriOf = new Map(concepts.map((c) => [c.id, c.iri]));
+    const walk = (id, path) => {
+        const at = path.indexOf(id);
+        if (at >= 0) {
+            const cycle = [...path.slice(at), id];
+            throw new SkosError('ERR_SKOS_CYCLE', `skos:broader forms a cycle: ${cycle.join(' → ')}; SKOS forbids a concept broader than itself.`, cycle.map((c) => iriOf.get(c) ?? c));
+        }
+        if (done.has(id))
+            return;
+        for (const next of broader.get(id) ?? [])
+            walk(next, [...path, id]);
+        done.add(id);
+    };
+    for (const concept of concepts)
+        walk(concept.id, []);
+}
+function readSchemeIdentity(typed, context) {
+    if (typed.schemes.length !== 1)
+        return {};
+    const scheme = typed.schemes[0];
+    const id = idFromIri(scheme.iri);
+    let version;
+    for (const iri of VERSION_IRIS) {
+        version = literalsOf(scheme.props, iri, context)[0]?.value;
+        if (version !== undefined)
+            break;
+    }
+    return {
+        iri: scheme.iri,
+        ...(id.length > 0 && { id }),
+        ...(version !== undefined && { version }),
+    };
+}
+// ─── The two doors ──────────────────────────────────────────────────────
+/**
+ * The pure parse: concepts (sorted by id), edges, and the scheme's identity
+ * when ONE `skos:ConceptScheme` node carries it. Refuses by code; never
+ * partial. Exported so a host can look before it joins, and for tests.
+ */
+export function readSkos(input, options = {}) {
+    const language = options.language ?? DEFAULT_LANGUAGE;
+    const doc = readDocument(input);
+    const typed = typeNodes(doc);
+    const concepts = readConcepts(typed, doc.context, language);
+    const edges = readEdges(typed, concepts, doc.context);
+    const scheme = readSchemeIdentity(typed, doc.context);
+    return Object.freeze({ ...scheme, language, concepts, edges });
+}
+/**
+ * The customer's scheme joined with the host's sources → an `OntologySpec`.
+ * The host calls `defineOntology(fromSkos(input, join))`: nothing is
+ * validated twice, and nothing is guessed — a term the join does not bind
+ * has no sources, which is the honest state.
+ */
+export function fromSkos(input, join) {
+    const typed = typeNodes(readDocument(input));
+    const scheme = readSkos(input, {
+        ...(join.language !== undefined && { language: join.language }),
+    });
+    const identity = settleIdentity(typed, scheme, join);
+    const bind = join.bind ?? {};
+    const known = new Set(scheme.concepts.map((c) => c.id));
+    for (const term of Object.keys(bind)) {
+        if (!known.has(term)) {
+            throw new SkosError('ERR_SKOS_BIND_UNKNOWN_TERM', `bind names term '${term}', which the scheme does not hold; expected one of: ${[
+                ...known,
+            ].join(', ')}.`);
+        }
+    }
+    const nodes = {};
+    for (const concept of scheme.concepts) {
+        const sources = bind[concept.id];
+        nodes[concept.id] = { ...concept.node, ...(sources !== undefined && { sources }) };
+    }
+    return {
+        id: identity.id,
+        version: identity.version,
+        sources: join.sources,
+        nodes,
+        edges: scheme.edges,
+    };
+}
+function settleIdentity(typed, scheme, join) {
+    if (typed.schemes.length > 1 && (join.id === undefined || join.version === undefined)) {
+        throw new SkosError('ERR_SKOS_SCHEME_AMBIGUOUS', `the document holds ${typed.schemes.length} skos:ConceptScheme nodes; expected one, or join.id and join.version to settle the identity.`, typed.schemes.map((s) => s.iri));
+    }
+    const id = join.id ?? scheme.id;
+    const version = join.version ?? scheme.version;
+    const where = scheme.iri === undefined ? 'no skos:ConceptScheme node' : `scheme '${scheme.iri}'`;
+    if (id === undefined) {
+        throw new SkosError('ERR_SKOS_SCHEME_MISSING', `no map id: join.id not given and ${where} yields no last IRI segment.`, scheme.iri ? [scheme.iri] : []);
+    }
+    if (version === undefined) {
+        throw new SkosError('ERR_SKOS_SCHEME_MISSING', `no map version: join.version not given and ${where} carries none of dcterms:modified, owl:versionInfo, schema:version.`, scheme.iri ? [scheme.iri] : []);
+    }
+    return { id, version };
+}
+//# sourceMappingURL=fromSkos.js.map

package/dist/esm/ontology/fromSkos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fromSkos.js","sourceRoot":"","sources":["../../../src/ontology/fromSkos.ts"],"names":[],"mappings":"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"}

package/dist/esm/ontology/index.d.ts

@@ -7,9 +7,15 @@
  * is the ONE way to build an `Ontology`; `.ontology(...)` on the agent
  * builder is the ONE way to mount it; `ontologyPiece` is the ONE composer of
  * what the model is served, called by the wire and by the rebuild.
+ * `fromSkos` / `readSkos` / `toSkos` (9.112.0) are the SKOS adapter — a
+ * customer's concept scheme in, our spec out, and back — never a second
+ * validation path: `defineOntology` still reads the result.
  */
 export { defineOntology, ontologyHash, ONTOLOGY_LIMITS } from './define.js';
 export { ONTOLOGY_INSTRUCTION, ONTOLOGY_INSTRUCTION_ID } from './instruction.js';
 export { ontologyPiece, ONTOLOGY_PIECE_LIMITS, type OntologyPiece } from './serve.js';
 export { scoreAbsence, summarizeAbsence, type AbsenceExpectation, type AbsenceScore, type AbsenceSummary, type AbsenceTurn, } from './score.js';
+export { fromSkos, readSkos, SkosError, type ReadSkosOptions, type SkosConcept, type SkosErrorCode, type SkosInput, type SkosJoin, type SkosScheme, } from './fromSkos.js';
+export { toSkos, SKOS_IRI_BASE, type SkosDocument, type ToSkosOptions } from './toSkos.js';
+export { SKOS_NS, FOOTPRINT_NS } from './skosJsonLd.js';
 export type { Ontology, OntologyAsk, OntologyEdge, OntologyJoin, OntologyNode, OntologyNodeSource, OntologyRecord, OntologySource, OntologySpec, } from './types.js';

package/dist/esm/ontology/index.js

@@ -7,9 +7,15 @@
  * is the ONE way to build an `Ontology`; `.ontology(...)` on the agent
  * builder is the ONE way to mount it; `ontologyPiece` is the ONE composer of
  * what the model is served, called by the wire and by the rebuild.
+ * `fromSkos` / `readSkos` / `toSkos` (9.112.0) are the SKOS adapter — a
+ * customer's concept scheme in, our spec out, and back — never a second
+ * validation path: `defineOntology` still reads the result.
  */
 export { defineOntology, ontologyHash, ONTOLOGY_LIMITS } from './define.js';
 export { ONTOLOGY_INSTRUCTION, ONTOLOGY_INSTRUCTION_ID } from './instruction.js';
 export { ontologyPiece, ONTOLOGY_PIECE_LIMITS } from './serve.js';
 export { scoreAbsence, summarizeAbsence, } from './score.js';
+export { fromSkos, readSkos, SkosError, } from './fromSkos.js';
+export { toSkos, SKOS_IRI_BASE } from './toSkos.js';
+export { SKOS_NS, FOOTPRINT_NS } from './skosJsonLd.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/ontology/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ontology/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAsB,MAAM,YAAY,CAAC;AACtF,OAAO,EACL,YAAY,EACZ,gBAAgB,GAKjB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ontology/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAsB,MAAM,YAAY,CAAC;AACtF,OAAO,EACL,YAAY,EACZ,gBAAgB,GAKjB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,SAAS,GAOV,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,MAAM,EAAE,aAAa,EAAyC,MAAM,aAAa,CAAC;AAC3F,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/esm/ontology/skosJsonLd.d.ts

@@ -0,0 +1,101 @@
+/**
+ * ontology/skosJsonLd — the JSON-LD spellings a SKOS document uses, resolved
+ * to IRIs with no inference.
+ *
+ * Pattern: pure functions over an already-parsed JSON-LD document; a
+ *          zero-import leaf under `fromSkos.ts`.
+ * Role:    Map (reader side). A key is resolved by the document's own
+ *          `@context` when it has one — a term mapping, a prefix, `@vocab` —
+ *          else by the fixed table of the vocabularies SKOS documents lean on
+ *          (`skos:`, `dcterms:`, `owl:`, `schema:`, `footprint:`). A full IRI
+ *          is itself. A bare key no context maps is NOT a SKOS property: it
+ *          is left unresolved, never guessed from its spelling.
+ * Emits:   N/A.
+ *
+ * Out of scope, by the owner's ruling (2026-09-18): a Turtle parser (the
+ * input is an OBJECT), remote `@context` fetching (a context given by URL is
+ * not resolved), OWL.
+ */
+/** The SKOS core namespace. */
+export declare const SKOS_NS = "http://www.w3.org/2004/02/skos/core#";
+/** The OWL namespace — read for `owl:versionInfo` only; OWL itself is out of scope. */
+export declare const OWL_NS = "http://www.w3.org/2002/07/owl#";
+/** Our own namespace for what SKOS cannot say: units, sources, tools, coverage, other relations. */
+export declare const FOOTPRINT_NS = "https://footprintjs.dev/ns/ontology#";
+/** The prefixes the reader knows without a context — the fixed table. */
+export declare const KNOWN_PREFIXES: Readonly<Record<string, string>>;
+/** The IRIs the reader looks at, by name. */
+export declare const SKOS: Readonly<{
+    readonly Concept: "http://www.w3.org/2004/02/skos/core#Concept";
+    readonly ConceptScheme: "http://www.w3.org/2004/02/skos/core#ConceptScheme";
+    readonly prefLabel: "http://www.w3.org/2004/02/skos/core#prefLabel";
+    readonly altLabel: "http://www.w3.org/2004/02/skos/core#altLabel";
+    readonly hiddenLabel: "http://www.w3.org/2004/02/skos/core#hiddenLabel";
+    readonly definition: "http://www.w3.org/2004/02/skos/core#definition";
+    readonly scopeNote: "http://www.w3.org/2004/02/skos/core#scopeNote";
+    readonly broader: "http://www.w3.org/2004/02/skos/core#broader";
+    readonly narrower: "http://www.w3.org/2004/02/skos/core#narrower";
+    readonly related: "http://www.w3.org/2004/02/skos/core#related";
+    readonly inScheme: "http://www.w3.org/2004/02/skos/core#inScheme";
+    readonly topConceptOf: "http://www.w3.org/2004/02/skos/core#topConceptOf";
+    readonly hasTopConcept: "http://www.w3.org/2004/02/skos/core#hasTopConcept";
+}>;
+/** Where a scheme's version may be written, in the order the reader looks. */
+export declare const VERSION_IRIS: readonly string[];
+/** The `footprint:` properties `toSkos` writes and `readSkos` reads back. */
+export declare const FOOTPRINT: Readonly<{
+    readonly unit: "https://footprintjs.dev/ns/ontology#unit";
+    readonly edge: "https://footprintjs.dev/ns/ontology#edge";
+    readonly to: "https://footprintjs.dev/ns/ontology#to";
+    readonly relation: "https://footprintjs.dev/ns/ontology#relation";
+    readonly meaning: "https://footprintjs.dev/ns/ontology#meaning";
+}>;
+export type JsonLdNode = Readonly<Record<string, unknown>>;
+/** A resolved `@context`: term → IRI, prefix → IRI, an optional `@vocab` and default `@language`. */
+export interface SkosContext {
+    readonly terms: ReadonlyMap<string, string>;
+    readonly prefixes: ReadonlyMap<string, string>;
+    readonly vocab?: string;
+    readonly language?: string;
+}
+export declare function isRecord(value: unknown): value is JsonLdNode;
+/**
+ * Read a `@context` (an object, an array of objects, or a URL — the last
+ * is not fetched). A term whose value is a string or `{ "@id": … }` maps
+ * to that IRI; a term whose value ends in `#` or `/` is also a prefix.
+ */
+export declare function readContext(context: unknown): SkosContext;
+/**
+ * Resolve a key or a `@type` / `@id` value to an IRI: a keyword stays a
+ * keyword; a term the context maps; `prefix:local`; a full IRI; a bare
+ * name under `@vocab`. Anything else stays as written (a bare literal),
+ * which no SKOS IRI ever equals — so it is ignored, not misread.
+ */
+export declare function expandIri(value: string, context: SkosContext): string;
+/** A node's properties keyed by expanded IRI (keywords keep their `@` names). */
+export declare function expandNode(node: JsonLdNode, context: SkosContext): ReadonlyMap<string, unknown>;
+/** Every value under a property as a flat list (`@list`, arrays and singles alike). */
+export declare function valuesOf(node: ReadonlyMap<string, unknown>, iri: string): readonly unknown[];
+/** The `@type` IRIs of a node. */
+export declare function typesOf(node: ReadonlyMap<string, unknown>, context: SkosContext): readonly string[];
+/** A language-tagged or plain literal. */
+export interface Literal {
+    readonly value: string;
+    readonly language?: string;
+}
+/** The literals under a property: plain strings, numbers and `{ "@value", "@language"? }` objects. */
+export declare function literalsOf(node: ReadonlyMap<string, unknown>, iri: string, context: SkosContext): readonly Literal[];
+/** The IRIs a property points at: strings (resolved) and `{ "@id": … }` objects. */
+export declare function irisOf(node: ReadonlyMap<string, unknown>, iri: string, context: SkosContext): readonly string[];
+/**
+ * The literal in the asked language: a label TAGGED with it wins; a label
+ * with no tag at all serves any language (it is not tagged as another);
+ * a label tagged with a different language is never taken. Tags compare
+ * case-insensitively and exactly (`en` is not `en-US`).
+ */
+export declare function inLanguage(literals: readonly Literal[], language: string): readonly string[];
+/**
+ * A concept id from its IRI: the last `/` or `#` segment, percent-decoded,
+ * lower-cased, `-` and spaces to `_`. Empty when the IRI ends in a delimiter.
+ */
+export declare function idFromIri(iri: string): string;