glossarist 0.4.1 → 0.4.3

package/src/rdf/predicates.js

@@ -0,0 +1,245 @@
+// AUTO-GENERATED by scripts/gen-predicates.mjs. Do not edit.
+// Source: data/concept-model/glossarist.context.jsonld
+// Regenerate via `npm run gen:predicates`.
+export const PRED = {
+  "gloss": {
+    "Concept": "https://www.glossarist.org/ontologies/Concept",
+    "ConceptCollection": "https://www.glossarist.org/ontologies/ConceptCollection",
+    "LocalizedConcept": "https://www.glossarist.org/ontologies/LocalizedConcept",
+    "Designation": "https://www.glossarist.org/ontologies/Designation",
+    "Expression": "https://www.glossarist.org/ontologies/Expression",
+    "Abbreviation": "https://www.glossarist.org/ontologies/Abbreviation",
+    "Symbol": "https://www.glossarist.org/ontologies/Symbol",
+    "LetterSymbol": "https://www.glossarist.org/ontologies/LetterSymbol",
+    "GraphicalSymbol": "https://www.glossarist.org/ontologies/GraphicalSymbol",
+    "Prefix": "https://www.glossarist.org/ontologies/Prefix",
+    "Suffix": "https://www.glossarist.org/ontologies/Suffix",
+    "Pronunciation": "https://www.glossarist.org/ontologies/Pronunciation",
+    "GrammarInfo": "https://www.glossarist.org/ontologies/GrammarInfo",
+    "DetailedDefinition": "https://www.glossarist.org/ontologies/DetailedDefinition",
+    "ConceptSource": "https://www.glossarist.org/ontologies/ConceptSource",
+    "Citation": "https://www.glossarist.org/ontologies/Citation",
+    "CitationRef": "https://www.glossarist.org/ontologies/CitationRef",
+    "ConceptRef": "https://www.glossarist.org/ontologies/ConceptRef",
+    "Reference": "https://www.glossarist.org/ontologies/Reference",
+    "RelatedConcept": "https://www.glossarist.org/ontologies/RelatedConcept",
+    "DesignationRelationship": "https://www.glossarist.org/ontologies/DesignationRelationship",
+    "ConceptDate": "https://www.glossarist.org/ontologies/ConceptDate",
+    "NonVerbalRepresentation": "https://www.glossarist.org/ontologies/NonVerbalRepresentation",
+    "CustomLocality": "https://www.glossarist.org/ontologies/CustomLocality",
+    "Locality": "https://www.glossarist.org/ontologies/Locality",
+    "DatasetRegister": "https://www.glossarist.org/ontologies/DatasetRegister",
+    "Section": "https://www.glossarist.org/ontologies/Section",
+    "identifier": "https://www.glossarist.org/ontologies/identifier",
+    "uri": "https://www.glossarist.org/ontologies/uri",
+    "hasLocalization": "https://www.glossarist.org/ontologies/hasLocalization",
+    "isLocalizationOf": "https://www.glossarist.org/ontologies/isLocalizationOf",
+    "hasStatus": "https://www.glossarist.org/ontologies/hasStatus",
+    "hasDomain": "https://www.glossarist.org/ontologies/hasDomain",
+    "hasRelatedConcept": "https://www.glossarist.org/ontologies/hasRelatedConcept",
+    "hasDate": "https://www.glossarist.org/ontologies/hasDate",
+    "hasSource": "https://www.glossarist.org/ontologies/hasSource",
+    "hasEntryStatus": "https://www.glossarist.org/ontologies/hasEntryStatus",
+    "hasDesignation": "https://www.glossarist.org/ontologies/hasDesignation",
+    "hasDefinition": "https://www.glossarist.org/ontologies/hasDefinition",
+    "hasNote": "https://www.glossarist.org/ontologies/hasNote",
+    "hasExample": "https://www.glossarist.org/ontologies/hasExample",
+    "hasScopedExample": "https://www.glossarist.org/ontologies/hasScopedExample",
+    "hasAnnotation": "https://www.glossarist.org/ontologies/hasAnnotation",
+    "hasNonVerbalRep": "https://www.glossarist.org/ontologies/hasNonVerbalRep",
+    "domain": "https://www.glossarist.org/ontologies/domain",
+    "release": "https://www.glossarist.org/ontologies/release",
+    "lineageSimilarity": "https://www.glossarist.org/ontologies/lineageSimilarity",
+    "reviewType": "https://www.glossarist.org/ontologies/reviewType",
+    "normativeStatus": "https://www.glossarist.org/ontologies/normativeStatus",
+    "hasPronunciation": "https://www.glossarist.org/ontologies/hasPronunciation",
+    "hasTermType": "https://www.glossarist.org/ontologies/hasTermType",
+    "classification": "https://www.glossarist.org/ontologies/classification",
+    "hasReference": "https://www.glossarist.org/ontologies/hasReference",
+    "hasGrammarInfo": "https://www.glossarist.org/ontologies/hasGrammarInfo",
+    "geographicalArea": "https://www.glossarist.org/ontologies/geographicalArea",
+    "isInternational": "https://www.glossarist.org/ontologies/isInternational",
+    "isAbsent": "https://www.glossarist.org/ontologies/isAbsent",
+    "register": "https://www.glossarist.org/ontologies/register",
+    "prefix": "https://www.glossarist.org/ontologies/prefix",
+    "usageInfo": "https://www.glossarist.org/ontologies/usageInfo",
+    "fieldOfApplication": "https://www.glossarist.org/ontologies/fieldOfApplication",
+    "isAcronym": "https://www.glossarist.org/ontologies/isAcronym",
+    "isInitialism": "https://www.glossarist.org/ontologies/isInitialism",
+    "isTruncation": "https://www.glossarist.org/ontologies/isTruncation",
+    "text": "https://www.glossarist.org/ontologies/text",
+    "image": "https://www.glossarist.org/ontologies/image",
+    "pronunciationContent": "https://www.glossarist.org/ontologies/pronunciationContent",
+    "pronunciationLanguage": "https://www.glossarist.org/ontologies/pronunciationLanguage",
+    "pronunciationScript": "https://www.glossarist.org/ontologies/pronunciationScript",
+    "pronunciationCountry": "https://www.glossarist.org/ontologies/pronunciationCountry",
+    "pronunciationSystem": "https://www.glossarist.org/ontologies/pronunciationSystem",
+    "relationshipType": "https://www.glossarist.org/ontologies/relationshipType",
+    "relationshipContent": "https://www.glossarist.org/ontologies/relationshipContent",
+    "relationshipRef": "https://www.glossarist.org/ontologies/relationshipRef",
+    "refType": "https://www.glossarist.org/ontologies/refType",
+    "urn": "https://www.glossarist.org/ontologies/urn",
+    "term": "https://www.glossarist.org/ontologies/term",
+    "refId": "https://www.glossarist.org/ontologies/refId",
+    "refVersion": "https://www.glossarist.org/ontologies/refVersion",
+    "refLink": "https://www.glossarist.org/ontologies/refLink",
+    "sourceType": "https://www.glossarist.org/ontologies/sourceType",
+    "sourceStatus": "https://www.glossarist.org/ontologies/sourceStatus",
+    "sourceId": "https://www.glossarist.org/ontologies/sourceId",
+    "sourceOrigin": "https://www.glossarist.org/ontologies/sourceOrigin",
+    "modification": "https://www.glossarist.org/ontologies/modification",
+    "hasCitationRef": "https://www.glossarist.org/ontologies/hasCitationRef",
+    "hasCitationLocality": "https://www.glossarist.org/ontologies/hasCitationLocality",
+    "citationOriginal": "https://www.glossarist.org/ontologies/citationOriginal",
+    "hasCustomLocality": "https://www.glossarist.org/ontologies/hasCustomLocality",
+    "citationRefSource": "https://www.glossarist.org/ontologies/citationRefSource",
+    "citationRefId": "https://www.glossarist.org/ontologies/citationRefId",
+    "citationRefVersion": "https://www.glossarist.org/ontologies/citationRefVersion",
+    "conceptRefSource": "https://www.glossarist.org/ontologies/conceptRefSource",
+    "conceptRefId": "https://www.glossarist.org/ontologies/conceptRefId",
+    "conceptRefText": "https://www.glossarist.org/ontologies/conceptRefText",
+    "customLocalityName": "https://www.glossarist.org/ontologies/customLocalityName",
+    "customLocalityValue": "https://www.glossarist.org/ontologies/customLocalityValue",
+    "citationLink": "https://www.glossarist.org/ontologies/citationLink",
+    "hasLocality": "https://www.glossarist.org/ontologies/hasLocality",
+    "dateValue": "https://www.glossarist.org/ontologies/dateValue",
+    "dateType": "https://www.glossarist.org/ontologies/dateType",
+    "eventDescription": "https://www.glossarist.org/ontologies/eventDescription",
+    "representationType": "https://www.glossarist.org/ontologies/representationType",
+    "representationRef": "https://www.glossarist.org/ontologies/representationRef",
+    "representationText": "https://www.glossarist.org/ontologies/representationText",
+    "localityType": "https://www.glossarist.org/ontologies/localityType",
+    "referenceFrom": "https://www.glossarist.org/ontologies/referenceFrom",
+    "referenceTo": "https://www.glossarist.org/ontologies/referenceTo",
+    "gender": "https://www.glossarist.org/ontologies/gender",
+    "number": "https://www.glossarist.org/ontologies/number",
+    "isNoun": "https://www.glossarist.org/ontologies/isNoun",
+    "isVerb": "https://www.glossarist.org/ontologies/isVerb",
+    "isAdjective": "https://www.glossarist.org/ontologies/isAdjective",
+    "isAdverb": "https://www.glossarist.org/ontologies/isAdverb",
+    "isPreposition": "https://www.glossarist.org/ontologies/isPreposition",
+    "isParticiple": "https://www.glossarist.org/ontologies/isParticiple",
+    "partOfSpeech": "https://www.glossarist.org/ontologies/partOfSpeech",
+    "script": "https://www.glossarist.org/ontologies/script",
+    "conversionSystem": "https://www.glossarist.org/ontologies/conversionSystem",
+    "deprecates": "https://www.glossarist.org/ontologies/deprecates",
+    "deprecatedBy": "https://www.glossarist.org/ontologies/deprecatedBy",
+    "supersedes": "https://www.glossarist.org/ontologies/supersedes",
+    "supersededBy": "https://www.glossarist.org/ontologies/supersededBy",
+    "compares": "https://www.glossarist.org/ontologies/compares",
+    "contrasts": "https://www.glossarist.org/ontologies/contrasts",
+    "sequentiallyRelated": "https://www.glossarist.org/ontologies/sequentiallyRelated",
+    "spatiallyRelated": "https://www.glossarist.org/ontologies/spatiallyRelated",
+    "temporallyRelated": "https://www.glossarist.org/ontologies/temporallyRelated",
+    "hasHomograph": "https://www.glossarist.org/ontologies/hasHomograph",
+    "hasFalseFriend": "https://www.glossarist.org/ontologies/hasFalseFriend",
+    "abbreviatedFormFor": "https://www.glossarist.org/ontologies/abbreviatedFormFor",
+    "shortFormFor": "https://www.glossarist.org/ontologies/shortFormFor",
+    "hasDesignationRelationship": "https://www.glossarist.org/ontologies/hasDesignationRelationship",
+    "designationRelationshipType": "https://www.glossarist.org/ontologies/designationRelationshipType",
+    "designationRelationshipContent": "https://www.glossarist.org/ontologies/designationRelationshipContent",
+    "relationshipTarget": "https://www.glossarist.org/ontologies/relationshipTarget",
+    "language": "https://www.glossarist.org/ontologies/language",
+    "datasetId": "https://www.glossarist.org/ontologies/datasetId",
+    "datasetRef": "https://www.glossarist.org/ontologies/datasetRef",
+    "datasetYear": "https://www.glossarist.org/ontologies/datasetYear",
+    "datasetUrn": "https://www.glossarist.org/ontologies/datasetUrn",
+    "datasetUrnAlias": "https://www.glossarist.org/ontologies/datasetUrnAlias",
+    "datasetRefAlias": "https://www.glossarist.org/ontologies/datasetRefAlias",
+    "datasetStatus": "https://www.glossarist.org/ontologies/datasetStatus",
+    "supersedesDataset": "https://www.glossarist.org/ontologies/supersedesDataset",
+    "owner": "https://www.glossarist.org/ontologies/owner",
+    "sourceRepo": "https://www.glossarist.org/ontologies/sourceRepo",
+    "datasetLanguage": "https://www.glossarist.org/ontologies/datasetLanguage",
+    "languageOrder": "https://www.glossarist.org/ontologies/languageOrder",
+    "hasSection": "https://www.glossarist.org/ontologies/hasSection",
+    "hasDefaultOrdering": "https://www.glossarist.org/ontologies/hasDefaultOrdering",
+    "datasetDescription": "https://www.glossarist.org/ontologies/datasetDescription",
+    "aboutPath": "https://www.glossarist.org/ontologies/aboutPath",
+    "logo": "https://www.glossarist.org/ontologies/logo",
+    "sectionId": "https://www.glossarist.org/ontologies/sectionId",
+    "sectionName": "https://www.glossarist.org/ontologies/sectionName",
+    "hasChildSection": "https://www.glossarist.org/ontologies/hasChildSection",
+    "hasParentSection": "https://www.glossarist.org/ontologies/hasParentSection",
+    "sectionOrdering": "https://www.glossarist.org/ontologies/sectionOrdering",
+    "$ns": "https://www.glossarist.org/ontologies/",
+  },
+
+  "skos": {
+    "prefLabel": "http://www.w3.org/2004/02/skos/core#prefLabel",
+    "altLabel": "http://www.w3.org/2004/02/skos/core#altLabel",
+    "hiddenLabel": "http://www.w3.org/2004/02/skos/core#hiddenLabel",
+    "definition": "http://www.w3.org/2004/02/skos/core#definition",
+    "scopeNote": "http://www.w3.org/2004/02/skos/core#scopeNote",
+    "note": "http://www.w3.org/2004/02/skos/core#note",
+    "example": "http://www.w3.org/2004/02/skos/core#example",
+    "notation": "http://www.w3.org/2004/02/skos/core#notation",
+    "inScheme": "http://www.w3.org/2004/02/skos/core#inScheme",
+    "hasTopConcept": "http://www.w3.org/2004/02/skos/core#hasTopConcept",
+    "broader": "http://www.w3.org/2004/02/skos/core#broader",
+    "narrower": "http://www.w3.org/2004/02/skos/core#narrower",
+    "related": "http://www.w3.org/2004/02/skos/core#related",
+    "exactMatch": "http://www.w3.org/2004/02/skos/core#exactMatch",
+    "closeMatch": "http://www.w3.org/2004/02/skos/core#closeMatch",
+    "broadMatch": "http://www.w3.org/2004/02/skos/core#broadMatch",
+    "narrowMatch": "http://www.w3.org/2004/02/skos/core#narrowMatch",
+    "relatedMatch": "http://www.w3.org/2004/02/skos/core#relatedMatch",
+    "$ns": "http://www.w3.org/2004/02/skos/core#",
+  },
+
+  "skosxl": {
+    "literalForm": "http://www.w3.org/2008/05/skos-xl#literalForm",
+    "labelRelation": "http://www.w3.org/2008/05/skos-xl#labelRelation",
+    "$ns": "http://www.w3.org/2008/05/skos-xl#",
+  },
+
+  "iso-thes": {
+    "broaderGeneric": "http://purl.org/iso25964/skos-thes#broaderGeneric",
+    "narrowerGeneric": "http://purl.org/iso25964/skos-thes#narrowerGeneric",
+    "broaderPartitive": "http://purl.org/iso25964/skos-thes#broaderPartitive",
+    "narrowerPartitive": "http://purl.org/iso25964/skos-thes#narrowerPartitive",
+    "broaderInstantial": "http://purl.org/iso25964/skos-thes#broaderInstantial",
+    "narrowerInstantial": "http://purl.org/iso25964/skos-thes#narrowerInstantial",
+    "$ns": "http://purl.org/iso25964/skos-thes#",
+  },
+
+  "dcterms": {
+    "bibliographicCitation": "http://purl.org/dc/terms/bibliographicCitation",
+    "$ns": "http://purl.org/dc/terms/",
+  },
+
+  "prov": {
+    "wasDerivedFrom": "http://www.w3.org/ns/prov#wasDerivedFrom",
+    "hadDerivation": "http://www.w3.org/ns/prov#hadDerivation",
+    "qualifiedDerivation": "http://www.w3.org/ns/prov#qualifiedDerivation",
+    "$ns": "http://www.w3.org/ns/prov#",
+  },
+
+  "rdfs": {
+    "label": "http://www.w3.org/2000/01/rdf-schema#label",
+    "comment": "http://www.w3.org/2000/01/rdf-schema#comment",
+    "seeAlso": "http://www.w3.org/2000/01/rdf-schema#seeAlso",
+    "subClassOf": "http://www.w3.org/2000/01/rdf-schema#subClassOf",
+    "$ns": "http://www.w3.org/2000/01/rdf-schema#",
+  },
+
+  "rdf": {
+    "value": "http://www.w3.org/1999/02/22-rdf-syntax-ns#value",
+    "$ns": "http://www.w3.org/1999/02/22-rdf-syntax-ns#",
+  },
+
+};
+
+export const PREFIXES = {
+  "gloss": "https://www.glossarist.org/ontologies/",
+  "skos": "http://www.w3.org/2004/02/skos/core#",
+  "skosxl": "http://www.w3.org/2008/05/skos-xl#",
+  "iso-thes": "http://purl.org/iso25964/skos-thes#",
+  "dcterms": "http://purl.org/dc/terms/",
+  "prov": "http://www.w3.org/ns/prov#",
+  "owl": "http://www.w3.org/2002/07/owl#",
+  "rdf": "http://www.w3.org/1999/02/22-rdf-syntax-ns#",
+  "rdfs": "http://www.w3.org/2000/01/rdf-schema#",
+  "xsd": "http://www.w3.org/2001/XMLSchema#",
+  "vann": "http://purl.org/vocab/vann/",
+};

package/src/rdf/prefixes.js

@@ -0,0 +1,31 @@
+// Re-export prefix map and predicate constants generated from the vendored
+// concept-model JSON-LD context. Downstream code should never duplicate
+// prefix bindings — always import from here.
+//
+// The JSON-LD context deliberately omits some "well-known" RDF and SKOS
+// constants (`rdf:type`, `skos:Concept`) because JSON-LD handles them via
+// the `@type` keyword. We construct those from the namespace URIs here so
+// downstream emitters don't have to repeat the construction.
+import { PRED, PREFIXES } from './predicates.js';
+
+export { PRED, PREFIXES };
+
+// SKOS-XL label predicates — same local name as SKOS, so we construct them
+// from the SKOS-XL namespace URI.
+const SKOSXL_NS = PRED.skosxl.$ns;
+export const SKOSXL = {
+  prefLabel: `${SKOSXL_NS}prefLabel`,
+  altLabel: `${SKOSXL_NS}altLabel`,
+  hiddenLabel: `${SKOSXL_NS}hiddenLabel`,
+  literalForm: `${SKOSXL_NS}literalForm`,
+};
+
+// Constants used in instance data but absent from the JSON-LD context.
+const RDF_NS = PREFIXES.rdf;
+const SKOS_NS = PREFIXES.skos;
+export const WELL_KNOWN = {
+  rdfType: `${RDF_NS}type`,
+  rdfValue: `${RDF_NS}value`,
+  skosConcept: `${SKOS_NS}Concept`,
+  skosxlLabel: `${SKOSXL_NS}Label`,
+};

package/src/rdf/shacl.js

@@ -0,0 +1,98 @@
+// SHACL validator wrapper. Loads vendored concept-model shapes once and
+// validates any RDFJS Dataset against them. Mirrors the mechanics of
+// glossarist-ruby's `Glossarist::Validation::ShaclValidator`.
+import { readFile } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import dataModel from '@rdfjs/data-model';
+import rdfDatasetFactory from '@rdfjs/dataset';
+import { Parser as N3Parser } from 'n3';
+import { default as ShaclValidator } from 'rdf-validate-shacl';
+
+// rdf-validate-shacl needs an RDFJS factory that produces both terms
+// and Datasets. @rdfjs/data-model is the spec-complete term factory;
+// @rdfjs/dataset adds the Dataset class.
+//
+// The data-model default export carries its methods on the prototype
+// (non-enumerable), so a spread ({ ...dataModel }) does not capture
+// them. List the RDF/JS surface explicitly.
+const FACTORY = {
+  namedNode: dataModel.namedNode.bind(dataModel),
+  blankNode: dataModel.blankNode.bind(dataModel),
+  literal: dataModel.literal.bind(dataModel),
+  variable: dataModel.variable.bind(dataModel),
+  defaultGraph: dataModel.defaultGraph.bind(dataModel),
+  quad: dataModel.quad.bind(dataModel),
+  fromTerm: dataModel.fromTerm.bind(dataModel),
+  fromQuad: dataModel.fromQuad.bind(dataModel),
+  dataset: rdfDatasetFactory.dataset.bind(rdfDatasetFactory),
+};
+const createDataset = FACTORY.dataset;
+const ShaclValidatorCtor = ShaclValidator.default ?? ShaclValidator;
+
+// Path to the vendored SHACL shapes (synced from glossarist/concept-model
+// via `npm run sync:model`). Resolved relative to this source file so it
+// works regardless of the consumer's cwd.
+const SHAPES_PATH = resolve(
+  dirname(fileURLToPath(import.meta.url)),
+  '..', '..',
+  'data', 'concept-model', 'shapes', 'glossarist.shacl.ttl',
+);
+
+// Note: SHAPES_PATH resolves relative to this source file. When the package
+// is installed, npm packs `data/concept-model/shapes/glossarist.shacl.ttl`
+// (see `files` in package.json) into `node_modules/glossarist/data/...`, so
+// the relative climb (`../..`) from `src/rdf/shacl.js` still lands on the
+// installed package root.
+
+// Cache keyed by absolute path so callers swapping shapes via the
+// `shapesPath` option (or future overrides) don't get cross-talk.
+const SHAPES_CACHE = new Map();
+
+async function parseTurtle(text, baseIri) {
+  const parser = new N3Parser({ baseIRI: baseIri });
+  const out = createDataset();
+  return new Promise((resolve, reject) => {
+    parser.parse(text, (err, quad) => {
+      if (err) reject(err);
+      else if (quad) out.add(quad);
+      else resolve(out);
+    });
+  });
+}
+
+export async function loadShapes({ shapesPath = SHAPES_PATH } = {}) {
+  const cached = SHAPES_CACHE.get(shapesPath);
+  if (cached) return cached;
+  const text = await readFile(shapesPath, 'utf8');
+  const dataset = await parseTurtle(text, `file://${shapesPath}`);
+  SHAPES_CACHE.set(shapesPath, dataset);
+  return dataset;
+}
+
+// Validates a single RDFJS Dataset against the concept-model SHACL shapes.
+// Returns the underlying ValidationReport from rdf-validate-shacl.
+//
+// Options:
+//   - shapes: a pre-loaded Dataset to use instead of the default shapes
+//   - shapesPath: alternative path to load shapes from (cached per path)
+export async function validateShacl(dataDataset, { shapes, shapesPath } = {}) {
+  const shapesDataset = shapes ?? await loadShapes({ shapesPath });
+  const validator = new ShaclValidatorCtor(shapesDataset, { factory: FACTORY });
+  return validator.validate(dataDataset);
+}
+
+// Convenience: builds an RDFJS Dataset from a quad iterable (e.g. the
+// output of conceptToQuads). Useful when chaining the RDF emitters with
+// SHACL validation.
+export function quadsToDataset(quads) {
+  const ds = createDataset();
+  for (const q of quads) ds.add(q);
+  return ds;
+}
+
+// Test-only: clears the shapes cache. Exported so tests can verify
+// independent caching per path without reaching into module internals.
+export function __clearShapesCacheForTests() {
+  SHAPES_CACHE.clear();
+}

package/src/rdf/terms.js

@@ -0,0 +1,15 @@
+// Shared RDF/JS term constructors. Replaces the per-emitter
+// `const { namedNode, literal, quad } = DataFactory;` pattern that was
+// repeated across the RDF layer.
+//
+// We use n3's DataFactory because it produces terms that are
+// interchangeable with @rdfjs/data-model output and because the rest
+// of the RDF layer (N3Parser, N3Writer) already speaks n3.
+
+import { DataFactory } from 'n3';
+
+export const namedNode = DataFactory.namedNode.bind(DataFactory);
+export const blankNode = DataFactory.blankNode.bind(DataFactory);
+export const literal = DataFactory.literal.bind(DataFactory);
+export const defaultGraph = DataFactory.defaultGraph.bind(DataFactory);
+export const quad = DataFactory.quad.bind(DataFactory);

package/src/transforms/concept-to-gloss.transform.js

@@ -0,0 +1,75 @@
+// ConceptToGlossTransform — JS port of glossarist-ruby's
+// `Transforms::ConceptToGlossTransform`. Converts a Concept model into
+// ontology-faithful RDF (Turtle, JSON-LD, N-Triples).
+//
+// Usage:
+//   import { ConceptToGlossTransform } from 'glossarist/transforms';
+//   const xform = new ConceptToGlossTransform({ registerId: 'iso-6709', uriBase: 'https://glossarist.org' });
+//   const ttl = await xform.toTurtle(concept);
+//   const jsonld = await xform.toJsonld(concept);
+//   const ttlAll = await xform.toTurtleAll(concepts);
+import { conceptToQuads } from '../rdf/gloss-concept.js';
+import {
+  collectQuads,
+  writeTurtle,
+  writeNTriples,
+  writeJsonld,
+} from '../rdf/document-writer.js';
+
+const DEFAULT_URI_BASE = 'https://glossarist.org';
+
+// Writer registry. Each entry is `{ write: (quads, transform) => Promise<string> }`.
+// Adding a new output format is a single entry here, not six new methods.
+const WRITERS = Object.freeze({
+  turtle:    { write: (quads) => writeTurtle(quads) },
+  ntriples:  { write: (quads) => writeNTriples(quads) },
+  jsonld:    { write: (quads, t) => writeJsonld(quads, t._jsonldOpts()) },
+});
+
+export class ConceptToGlossTransform {
+  constructor(options = {}) {
+    this.registerId = options.registerId;
+    this.uriBase = (options.uriBase ?? DEFAULT_URI_BASE).replace(/\/+$/, '');
+    this.jsonldContext = options.jsonldContext;
+  }
+
+  toTurtle(target)    { return this._serialize(target, 'turtle'); }
+  toTurtleAll(targets) { return this._serialize(targets, 'turtle'); }
+  toJsonld(target)    { return this._serialize(target, 'jsonld'); }
+  toJsonldAll(targets) { return this._serialize(targets, 'jsonld'); }
+  toNTriples(target)  { return this._serialize(target, 'ntriples'); }
+  toNTriplesAll(targets) { return this._serialize(targets, 'ntriples'); }
+
+  // Single dispatcher: collect quads for one concept or many, then hand
+  // off to the registered writer. Replaces six near-identical methods.
+  async _serialize(target, format) {
+    const writer = WRITERS[format];
+    if (!writer) throw new Error(`Unknown serialization format: ${format}`);
+    const quads = this._collect(target);
+    return writer.write(quads, this);
+  }
+
+  _collect(target) {
+    if (target && typeof target[Symbol.iterator] === 'function') {
+      const quads = [];
+      for (const concept of target) {
+        for (const q of conceptToQuads(concept, this._optsFor(concept))) {
+          quads.push(q);
+        }
+      }
+      return quads;
+    }
+    return collectQuads(conceptToQuads(target, this._optsFor(target)));
+  }
+
+  _optsFor(concept) {
+    return {
+      registerId: this.registerId ?? concept.registerId ?? 'glossary',
+      uriBase: this.uriBase,
+    };
+  }
+
+  _jsonldOpts() {
+    return this.jsonldContext ? { context: this.jsonldContext } : {};
+  }
+}

package/src/transforms/index.d.ts

@@ -0,0 +1,26 @@
+// Type declarations for the public transforms layer.
+//
+// Mirrors the runtime exports of src/transforms/index.js.
+
+import type { Concept } from '../models/index';
+import type { Quad } from '@rdfjs/dataset';
+
+export interface ConceptToGlossTransformOptions {
+  registerId?: string;
+  uriBase?: string;
+  jsonldContext?: Record<string, string>;
+}
+
+export declare class ConceptToGlossTransform {
+  constructor(options?: ConceptToGlossTransformOptions);
+  readonly registerId: string | undefined;
+  readonly uriBase: string;
+  readonly jsonldContext: Record<string, string> | undefined;
+
+  toTurtle(concept: Concept): Promise<string>;
+  toTurtleAll(concepts: Iterable<Concept>): Promise<string>;
+  toJsonld(concept: Concept): Promise<string>;
+  toJsonldAll(concepts: Iterable<Concept>): Promise<string>;
+  toNTriples(concept: Concept): Promise<string>;
+  toNTriplesAll(concepts: Iterable<Concept>): Promise<string>;
+}

package/src/transforms/index.js

@@ -0,0 +1 @@
+export { ConceptToGlossTransform } from './concept-to-gloss.transform.js';

package/src/v1-reader.js

@@ -1,6 +1,6 @@
 import fs from 'fs';
 import path from 'path';
-import yaml from 'js-yaml';
+import * as yaml from 'js-yaml';
 import { Concept } from './models/concept.js';
 import { InvalidInputError } from './errors.js';
 

package/src/validators/gcr-validator.js

@@ -1,4 +1,4 @@
-import yaml from 'js-yaml';
+import * as yaml from 'js-yaml';
 import { DATASET_ASSETS } from '../dataset-asset.js';
 import { ValidationResult } from './validation-result.js';