glossarist 0.4.50 → 0.4.52

package/src/rdf/agents-emitter.ts

@@ -1,137 +0,0 @@
-// Agents emitter — emits foaf:Person / prov:Organization from
-// contributor declarations. Mirrors concept-browser's agents-emitter.ts.
-//
-// Each contributor becomes a foaf:Person + prov:Person + prov:Agent
-// with foaf:name, optional foaf:mbox (mailto link), rdfs:seeAlso (url).
-// Their organization (when provided) becomes a foaf:Organization +
-// prov:Organization, and the person is linked via prov:actedOnBehalfOf.
-
-import { namedNode, literal, quad } from './terms.js';
-import { PREFIXES } from './prefixes.js';
-import { RDF_TYPE } from './curie.js';
-
-const PROV_NS    = PREFIXES.prov;
-const FOAF_NS    = PREFIXES.foaf ?? 'http://xmlns.com/foaf/0.1/';
-const DCTERMS_NS = PREFIXES.dcterms;
-const RDFS_NS    = PREFIXES.rdfs;
-
-const PROV = {
-  Person: `${PROV_NS}Person`,
-  Organization: `${PROV_NS}Organization`,
-  Agent: `${PROV_NS}Agent`,
-  actedOnBehalfOf: `${PROV_NS}actedOnBehalfOf`,
-};
-const FOAF = {
-  Person: `${FOAF_NS}Person`,
-  Organization: `${FOAF_NS}Organization`,
-  name: `${FOAF_NS}name`,
-  mbox: `${FOAF_NS}mbox`,
-};
-const DCTERMS = {
-  description: `${DCTERMS_NS}description`,
-};
-const RDFS = {
-  seeAlso: `${RDFS_NS}seeAlso`,
-};
-
-// No hardcoded default agent/org base URIs. Callers MUST pass agentBase
-// explicitly so agent IRIs reflect the consumer's domain.
-
-/**
- * @typedef {Object} Contributor
- * @property {string} name
- * @property {string} [role]
- * @property {string} [organization]
- * @property {string} [url]
- * @property {string} [email]
- */
-/**
- * @typedef {Contributor & { slug: string, agentIri: string }} AgentInput
- */
-
-/**
- * Slugify a name for IRIs. Lowercase, ASCII, hyphenated.
- */
-export function slugify(input) {
-  return String(input)
-    .toLowerCase()
-    .normalize('NFKD')
-    .replace(/[̀-ͯ]/g, '')
-    .replace(/[^a-z0-9]+/g, '-')
-    .replace(/^-+|-+$/g, '');
-}
-
-/**
- * Builds AgentInput records from raw contributor declarations.
- * Useful for callers that want to inspect the IRIs before emission.
- */
-export function agentsFromContributors(contributors, agentBase) {
-  if (!agentBase) throw new Error('agentsFromContributors requires agentBase — the deployment canonical URI root for agents (e.g. https://www.example.org/agent). glossarist-js does NOT default to glossarist.org.');
-  return (contributors ?? []).map(c => {
-    const slug = slugify(c.name);
-    return {
-      slug,
-      name: c.name,
-      role: c.role,
-      organization: c.organization,
-      url: c.url,
-      email: c.email,
-      agentIri: `${agentBase}/${slug}`,
-    };
-  });
-}
-
-/**
- * Emits foaf:Person + prov:Organization quads for a list of agents.
- *
- * Returns a generator of quads AND the set of unique person and
- * organization IRIs emitted. Organizations are deduplicated — the
- * same org across multiple contributors is emitted once.
- *
- * @param {readonly AgentInput[]} agents
- * @param {Object} [options]
- * @param {string} [options.orgBase] — default https://glossarist.org/org
- * @returns {Generator<Quad, void, unknown>}
- */
-export function* agentsToQuads(agents: Record<string, unknown>[], options: Record<string, unknown> = {}) {
-  const orgBase = options.orgBase;
-  if (!orgBase) throw new Error('agentsToQuads requires options.orgBase — the deployment canonical URI root for organizations.');
-  const emittedOrgs = new Set();
-
-  for (const a of agents ?? []) {
-    // @ts-expect-error TODO(Phase 2e): type this fully
-    const person = namedNode(a.agentIri);
-    yield quad(person, namedNode(RDF_TYPE), namedNode(FOAF.Person));
-    yield quad(person, namedNode(RDF_TYPE), namedNode(PROV.Person));
-    yield quad(person, namedNode(RDF_TYPE), namedNode(PROV.Agent));
-    yield quad(person, namedNode(FOAF.name), literal((a as Record<string, unknown>).name as string));
-
-    if ((a as Record<string, unknown>).email as string) {
-      yield quad(person, namedNode(FOAF.mbox), namedNode(`mailto:${(a as Record<string, unknown>).email as string}`));
-    }
-    if (a.url) {
-      // @ts-expect-error TODO(Phase 2e): type this fully
-      yield quad(person, namedNode(RDFS.seeAlso), namedNode(a.url));
-    }
-    if (a.role) {
-      // @ts-expect-error TODO(Phase 2e): type this fully
-      yield quad(person, namedNode(DCTERMS.description), literal(a.role));
-    }
-
-    if (a.organization) {
-      const orgSlug = slugify(a.organization);
-      const orgIri = `${orgBase}/${orgSlug}`;
-      yield quad(person, namedNode(PROV.actedOnBehalfOf), namedNode(orgIri));
-
-      if (!emittedOrgs.has(orgIri)) {
-        emittedOrgs.add(orgIri);
-        const org = namedNode(orgIri);
-        yield quad(org, namedNode(RDF_TYPE), namedNode(FOAF.Organization));
-        yield quad(org, namedNode(RDF_TYPE), namedNode(PROV.Organization));
-        yield quad(org, namedNode(RDF_TYPE), namedNode(PROV.Agent));
-        // @ts-expect-error TODO(Phase 2e): type this fully
-        yield quad(org, namedNode(FOAF.name), literal(a.organization));
-      }
-    }
-  }
-}

package/src/rdf/bibliography-emitter.ts

@@ -1,126 +0,0 @@
-// Bibliography emitter — emits dcterms:BibliographicResource per
-// bibliography entry. Mirrors concept-browser's bibliography-emitter.ts.
-//
-// Each entry becomes a typed resource with:
-// - dcterms:identifier (the entry id)
-// - dcterms:bibliographicCitation (the reference string)
-// - dcterms:title (optional)
-// - foaf:page (optional link)
-// - dcterms:type (optional, value URIs from gloss:bibtype/*)
-// - dcterms:isPartOf (parent dataset)
-
-import { namedNode, literal, quad } from './terms.js';
-import { PREFIXES } from './prefixes.js';
-import { RDF_TYPE } from './curie.js';
-
-// Namespace IRIs from canonical PREFIXES. foaf is absent from the
-// JSON-LD context (therefore not in PREFIXES) — declare locally.
-const DCTERMS_NS = PREFIXES.dcterms;
-const FOAF_NS    = PREFIXES.foaf ?? 'http://xmlns.com/foaf/0.1/';
-const GLOSS_NS   = PREFIXES.gloss;
-
-const DCTERMS = {
-  BibliographicResource: `${DCTERMS_NS}BibliographicResource`,
-  identifier: `${DCTERMS_NS}identifier`,
-  bibliographicCitation: `${DCTERMS_NS}bibliographicCitation`,
-  title: `${DCTERMS_NS}title`,
-  type: `${DCTERMS_NS}type`,
-  isPartOf: `${DCTERMS_NS}isPartOf`,
-};
-const FOAF = {
-  page: `${FOAF_NS}page`,
-};
-
-// No hardcoded default base URI. Callers MUST pass baseUri explicitly
-// so instance IRIs reflect the consumer's domain, not the library's.
-
-/**
- * @typedef {Object} BibliographyEntry
- * @property {string} id
- * @property {string} reference
- * @property {string} [title]
- * @property {string} [link]
- * @property {string} [type]
- */
-/**
- * @typedef {Object} BibliographyInput
- * @property {string} registerId
- * @property {readonly BibliographyEntry[]} entries
- * @property {string} [baseUri]
- */
-
-/**
- * Returns the canonical IRI for a bibliography entry.
- *
- * @param {string} registerId
- * @param {string} entryId
- * @param {string} [baseUri]
- */
-export function bibliographyEntryIri(registerId, entryId, baseUri) {
-  if (!baseUri) throw new Error('bibliographyEntryIri requires baseUri — the deployment canonical URI root. glossarist-js does NOT default to glossarist.org because instance data identity must reflect the consumer domain.');
-  return `${baseUri}/${registerId}/bib/${entryId}`;
-}
-
-/**
- * Emits dcterms:BibliographicResource quads for each entry. Entries
- * without an id or reference are skipped (matches concept-browser).
- *
- * @param {BibliographyInput} input
- * @returns {Generator<Quad, void, unknown>}
- */
-export function* bibliographyToQuads(input) {
-  const baseUri = input.baseUri;
-  if (!baseUri) throw new Error('bibliographyToQuads requires input.baseUri — the deployment canonical URI root.');
-  const parentIri = `${baseUri}/${input.registerId}/`;
-
-  for (const entry of input.entries ?? []) {
-    if (!entry.id || !entry.reference) continue;
-    const entryIri = bibliographyEntryIri(input.registerId, entry.id, baseUri);
-    const e = namedNode(entryIri);
-
-    yield quad(e, namedNode(RDF_TYPE), namedNode(DCTERMS.BibliographicResource));
-    yield quad(e, namedNode(DCTERMS.identifier), literal(entry.id));
-    yield quad(e, namedNode(DCTERMS.bibliographicCitation), literal(entry.reference));
-    if (entry.title) {
-      yield quad(e, namedNode(DCTERMS.title), literal(entry.title));
-    }
-    if (entry.link) {
-      yield quad(e, namedNode(FOAF.page), namedNode(entry.link));
-    }
-    if (entry.type) {
-      yield quad(e, namedNode(DCTERMS.type), namedNode(`${GLOSS_NS}bibtype/${entry.type}`));
-    }
-    yield quad(e, namedNode(DCTERMS.isPartOf), namedNode(parentIri));
-  }
-}
-
-/**
- * Normalizes raw bibliography data from a v3 YAML bibliography file.
- * Accepts both shapes:
- *   - { bibliography: [...] }
- *   - { <id>: { ... }, <id>: { ... } }
- *
- * Returns a flat list of BibliographyEntry objects with explicit ids.
- */
-export function normalizeBibliographyData(raw) {
-  if (!raw || typeof raw !== 'object') return [];
-  if (Array.isArray(raw.bibliography)) {
-    return raw.bibliography.map(e => entryFromV3(e, null));
-  }
-  const entries: unknown[] = [];
-  for (const [id, value] of Object.entries(raw)) {
-    if (!value || typeof value !== 'object') continue;
-    entries.push(entryFromV3(value, id));
-  }
-  return entries;
-}
-
-function entryFromV3(e, fallbackId) {
-  return {
-    id: e.id ?? fallbackId ?? '',
-    reference: e.reference ?? '',
-    title: e.title,
-    link: e.link,
-    type: e.type,
-  };
-}

package/src/rdf/bnode-id.ts

@@ -1,55 +0,0 @@
-// Deterministic blank node ID strategy.
-//
-// Single source of truth for bnode IDs across all emitters. Previously
-// each emitter had its own local FNV-1a hash, producing different IDs
-// for the same logical bnode. This module replaces those with one
-// strategy: MD5 (via node:crypto) when available, FNV-1a fallback for
-// browser bundles.
-//
-// Browser safety: node:crypto is loaded lazily via runtime check so
-// bundlers don't tree-shake the import into the browser bundle.
-
-let nodeCreateHash: ((alg: string) => { update(data: string): { digest(enc: string): string } }) | null = null;
-let nodeCryptoChecked = false;
-
-function getNodeCreateHash() {
-  if (nodeCryptoChecked) return nodeCreateHash;
-  nodeCryptoChecked = true;
-  try {
-    let requireFn;
-    try {
-      const mod = (Function('m', 'return require(m)'))('node:module');
-      requireFn = mod.createRequire(import.meta.url);
-    } catch {
-      requireFn = (m: string) => (Function('m', 'return require(m)'))(m);
-    }
-    const crypto = requireFn('node:crypto');
-    nodeCreateHash = crypto.createHash.bind(crypto);
-  } catch {
-    nodeCreateHash = null;
-  }
-  return nodeCreateHash;
-}
-
-function fnv1a(seed: string): string {
-  let h = 0x811c9dc5;
-  for (let i = 0; i < seed.length; i++) {
-    h ^= seed.charCodeAt(i);
-    h = Math.imul(h, 0x01000193);
-  }
-  return (h >>> 0).toString(16).padStart(8, '0');
-}
-
-export function deterministicBnodeId(...parts: ReadonlyArray<unknown>): string {
-  const seed = parts.filter(p => p != null && p !== '').join('|');
-  if (!seed) return `b${fnv1a('empty')}`;
-  const createHash = getNodeCreateHash();
-  if (createHash) {
-    try {
-      return createHash('md5').update(seed).digest('hex').slice(0, 12);
-    } catch {
-      // fall through to FNV
-    }
-  }
-  return `b${fnv1a(seed)}`;
-}

package/src/rdf/build-activity-emitter.ts

@@ -1,129 +0,0 @@
-// Build activity emitter — emits prov:Activity per build run.
-// Mirrors concept-browser's build-activity-emitter.ts.
-//
-// Models a single CI build as a prov:Activity with:
-// - prov:StartingPoint and prov:EndingPoint time bounds
-// - prov:used links to the git commit, the build tool (prov:SoftwareAgent),
-//   and each dataset register
-// - gloss:conceptCount for the build output
-// - prov:wasAssociatedWith for the CI bot agent
-
-import { namedNode, literal, quad } from './terms.js';
-import { PREFIXES } from './prefixes.js';
-import { RDF_TYPE } from './curie.js';
-
-const PROV_NS    = PREFIXES.prov;
-const DCTERMS_NS = PREFIXES.dcterms;
-const FOAF_NS    = PREFIXES.foaf ?? 'http://xmlns.com/foaf/0.1/';
-const GLOSS_NS   = PREFIXES.gloss;
-const XSD_NS     = PREFIXES.xsd;
-
-const PROV = {
-  Activity: `${PROV_NS}Activity`,
-  StartingPoint: `${PROV_NS}StartingPoint`,
-  EndingPoint: `${PROV_NS}EndingPoint`,
-  Entity: `${PROV_NS}Entity`,
-  SoftwareAgent: `${PROV_NS}SoftwareAgent`,
-  Agent: `${PROV_NS}Agent`,
-  Person: `${PROV_NS}Person`,
-  generatedAtTime: `${PROV_NS}generatedAtTime`,
-  atTime: `${PROV_NS}atTime`,
-  used: `${PROV_NS}used`,
-  wasAssociatedWith: `${PROV_NS}wasAssociatedWith`,
-  version: `${PROV_NS}version`,
-};
-const DCTERMS = {
-  identifier: `${DCTERMS_NS}identifier`,
-  description: `${DCTERMS_NS}description`,
-};
-const FOAF = {
-  Person: `${FOAF_NS}Person`,
-};
-const GLOSS = {
-  conceptCount: `${GLOSS_NS}conceptCount`,
-};
-const XSD_DATE_TIME = `${XSD_NS}dateTime`;
-const XSD_INTEGER = `${XSD_NS}integer`;
-
-/**
- * @typedef {Object} BuildActivityInput
- * @property {string} runId
- * @property {string} startedAt — ISO date-time
- * @property {string} endedAt — ISO date-time
- * @property {string} [gitSha]
- * @property {string} [gitBranch]
- * @property {string} toolId
- * @property {string} toolVersion
- * @property {readonly string[]} datasetRegisters
- * @property {number} conceptCount
- * @property {string} [associatedAgentIri]
- * @property {string} [baseUri] — default https://glossarist.org
- */
-
-/**
- * Returns the canonical relative IRI for a build activity.
- */
-export function buildActivityIri(input) {
-  return `activity/build/${input.runId}`;
-}
-
-/**
- * Emits prov:Activity quads for one build run, including the
- * starting/ending time bounds, the build tool as prov:SoftwareAgent,
- * the git commit (when provided) as a prov:Entity, and each dataset
- * register as a prov:used target.
- *
- * @param {BuildActivityInput} input
- * @returns {Generator<Quad, void, unknown>}
- */
-export function* buildActivityToQuads(input) {
-  const baseUri = input.baseUri;
-  if (!baseUri) throw new Error('buildActivityToQuads requires input.baseUri — the deployment canonical URI root. glossarist-js does NOT default to glossarist.org because instance data identity must reflect the consumer domain.');
-  const activityIri = `${baseUri}/${buildActivityIri(input)}`;
-  const activity = namedNode(activityIri);
-
-  yield quad(activity, namedNode(RDF_TYPE), namedNode(PROV.Activity));
-  yield quad(activity, namedNode(PROV.generatedAtTime), literal(input.endedAt, namedNode(XSD_DATE_TIME)));
-
-  // StartingPoint and EndingPoint are sub-types of prov:TimeBound.
-  // Modeling them as separate resources lets consumers query exact
-  // start vs end without parsing date ranges.
-  const start = namedNode(`${activityIri}/start`);
-  yield quad(start, namedNode(RDF_TYPE), namedNode(PROV.StartingPoint));
-  yield quad(start, namedNode(PROV.atTime), literal(input.startedAt, namedNode(XSD_DATE_TIME)));
-
-  const end = namedNode(`${activityIri}/end`);
-  yield quad(end, namedNode(RDF_TYPE), namedNode(PROV.EndingPoint));
-  yield quad(end, namedNode(PROV.atTime), literal(input.endedAt, namedNode(XSD_DATE_TIME)));
-
-  if (input.gitSha) {
-    const commitIri = `${baseUri}/commit/${input.gitSha}`;
-    yield quad(activity, namedNode(PROV.used), namedNode(commitIri));
-    const commit = namedNode(commitIri);
-    yield quad(commit, namedNode(RDF_TYPE), namedNode(PROV.Entity));
-    if (input.gitBranch) {
-      yield quad(commit, namedNode(DCTERMS.description), literal(`branch: ${input.gitBranch}`));
-    }
-  }
-
-  const toolIri = `${baseUri}/tool/${input.toolId}/${input.toolVersion}`;
-  yield quad(activity, namedNode(PROV.used), namedNode(toolIri));
-  const tool = namedNode(toolIri);
-  yield quad(tool, namedNode(RDF_TYPE), namedNode(PROV.Entity));
-  yield quad(tool, namedNode(RDF_TYPE), namedNode(PROV.SoftwareAgent));
-  yield quad(tool, namedNode(DCTERMS.identifier), literal(input.toolVersion));
-  yield quad(tool, namedNode(PROV.version), literal(input.toolVersion));
-
-  for (const register of input.datasetRegisters ?? []) {
-    yield quad(activity, namedNode(PROV.used), namedNode(`${baseUri}/${register}/`));
-  }
-
-  yield quad(activity, namedNode(GLOSS.conceptCount), literal(String(input.conceptCount), namedNode(XSD_INTEGER)));
-
-  if (input.associatedAgentIri) {
-    yield quad(activity, namedNode(PROV.wasAssociatedWith), namedNode(input.associatedAgentIri));
-    const agent = namedNode(input.associatedAgentIri);
-    yield quad(agent, namedNode(RDF_TYPE), namedNode(PROV.Agent));
-    yield quad(agent, namedNode(RDF_TYPE), namedNode(FOAF.Person));
-  }
-}

package/src/rdf/curie.ts

@@ -1,46 +0,0 @@
-// CURIE helpers — resolve/compact IRIs against the canonical PREFIXES.
-//
-// Single source of truth for CURIE ↔ IRI conversion. Previously
-// `resolveIri` was private to vocabulary-emitter and reimplemented
-// (incorrectly) in other emitters. Callers now import from here.
-
-import { PREFIXES } from './prefixes.js';
-
-const ABSOLUTE_SCHEMES = new Set(['http', 'https', 'urn', 'file', 'mailto', 'ftp']);
-
-export function isAbsoluteIri(s: string): boolean {
-  if (typeof s !== 'string' || s.length === 0) return false;
-  if (s.startsWith('urn:')) return true;
-  const colon = s.indexOf(':');
-  if (colon < 1) return false;
-  return ABSOLUTE_SCHEMES.has(s.slice(0, colon));
-}
-
-export function resolveIri(iri: string, prefixes: Record<string, string> = PREFIXES): string {
-  if (isAbsoluteIri(iri)) return iri;
-  const colon = iri.indexOf(':');
-  if (colon < 1) return iri;
-  const prefix = iri.slice(0, colon);
-  const local = iri.slice(colon + 1);
-  const base = prefixes[prefix as keyof typeof PREFIXES];
-  return base ? `${base}${local}` : iri;
-}
-
-export function compactIri(iri: string, prefixes: Record<string, string> = PREFIXES): string {
-  let best = null;
-  let bestLen = 0;
-  for (const [prefix, base] of Object.entries(prefixes)) {
-    if (iri.startsWith(base) && base.length > bestLen) {
-      // @ts-expect-error TODO(Phase 2e): type this fully
-      best = `${prefix}:${iri.slice(base.length)}`;
-      bestLen = base.length;
-    }
-  }
-  return best ?? iri;
-}
-
-// Convenience constants — used by every emitter. Centralized here so
-// the IRI string appears in exactly one place.
-export const RDF_TYPE = `${PREFIXES.rdf}type`;
-export const RDF_VALUE = `${PREFIXES.rdf}value`;
-export const RDFS_LABEL = `${PREFIXES.rdfs}label`;

package/src/rdf/dataset-emitter.ts

@@ -1,170 +0,0 @@
-// Dataset emitter — emits dcat:Dataset + skos:ConceptScheme per
-// register. Mirrors concept-browser's dataset-emitter.ts.
-//
-// The dataset describes the vocabulary as a whole: title, description,
-// modified date, languages, distributions (Turtle/JSON-LD/YAML), top
-// concepts, sections, source repo, publisher, contact.
-//
-// Each section becomes a skos:Collection linked via skos:member to
-// its concept URIs and via gloss:hasParentSection / gloss:hasChildSection
-// to its relatives (the ontology declares these as owl:TransitiveProperty
-// for cascading section membership).
-
-import { namedNode, blankNode, literal, quad } from './terms.js';
-import { PREFIXES } from './prefixes.js';
-import { RDF_TYPE } from './curie.js';
-import { deterministicBnodeId } from './bnode-id.js';
-
-// Namespace IRIs from the canonical PREFIXES — single source of truth.
-const DCAT_NS    = PREFIXES.dcat ?? 'http://www.w3.org/ns/dcat#';
-const DCTERMS_NS = PREFIXES.dcterms;
-const SKOS_NS    = PREFIXES.skos;
-const PROV_NS    = PREFIXES.prov;
-const GLOSS_NS   = PREFIXES.gloss;
-const XSD_NS     = PREFIXES.xsd;
-
-/**
- * @typedef {Object} DatasetDistribution
- * @property {string} id
- * @property {string} title
- * @property {string} mediaType
- * @property {string} downloadUrl
- * @property {number} [byteSize]
- */
-/**
- * @typedef {Object} DatasetSection
- * @property {string} collectionIri
- * @property {string} title
- * @property {readonly string[]} memberUris
- * @property {string} [parentCollectionIri]
- * @property {readonly string[]} [childCollectionIris]
- */
-/**
- * @typedef {Object} DatasetEmitterInput
- * @property {string} datasetIri
- * @property {string} registerId
- * @property {string} title
- * @property {string} [description]
- * @property {string} modified — ISO date (YYYY-MM-DD)
- * @property {readonly string[]} languages
- * @property {readonly DatasetDistribution[]} distributions
- * @property {readonly string[]} topConceptUris
- * @property {readonly DatasetSection[]} sections
- * @property {string} [sourceRepoUrl]
- * @property {string} [publisherIri]
- * @property {string} [contactIri]
- */
-
-const DCAT = {
-  Dataset: `${DCAT_NS}Dataset`,
-  ConceptScheme: `${SKOS_NS}ConceptScheme`,
-  Distribution: `${DCAT_NS}Distribution`,
-  Collection: `${SKOS_NS}Collection`,
-  mediaType: `${DCAT_NS}mediaType`,
-  downloadURL: `${DCAT_NS}downloadURL`,
-  byteSize: `${DCAT_NS}byteSize`,
-  distribution: `${DCAT_NS}distribution`,
-  contactPoint: `${DCAT_NS}contactPoint`,
-};
-const DCTERMS = {
-  title: `${DCTERMS_NS}title`,
-  description: `${DCTERMS_NS}description`,
-  modified: `${DCTERMS_NS}modified`,
-  identifier: `${DCTERMS_NS}identifier`,
-  language: `${DCTERMS_NS}language`,
-  publisher: `${DCTERMS_NS}publisher`,
-};
-const SKOS = {
-  hasTopConcept: `${SKOS_NS}hasTopConcept`,
-  member: `${SKOS_NS}member`,
-};
-const PROV = {
-  wasDerivedFrom: `${PROV_NS}wasDerivedFrom`,
-};
-const GLOSS = {
-  hasParentSection: `${GLOSS_NS}hasParentSection`,
-  hasChildSection: `${GLOSS_NS}hasChildSection`,
-};
-const XSD_DATE = `${XSD_NS}date`;
-const XSD_INTEGER = `${XSD_NS}integer`;
-
-/**
- * Emits dcat:Dataset + skos:ConceptScheme quads for one register's
- * metadata, plus its distributions, sections, and top concepts.
- *
- * @param {DatasetEmitterInput} input
- * @returns {Generator<Quad, void, unknown>}
- */
-export function* datasetToQuads(input) {
-  const ds = namedNode(input.datasetIri);
-
-  yield quad(ds, namedNode(RDF_TYPE), namedNode(DCAT.Dataset));
-  yield quad(ds, namedNode(RDF_TYPE), namedNode(DCAT.ConceptScheme));
-  yield quad(ds, namedNode(DCTERMS.title), literal(input.title));
-  if (input.description) {
-    yield quad(ds, namedNode(DCTERMS.description), literal(input.description));
-  }
-  yield quad(ds, namedNode(DCTERMS.modified), literal(input.modified, namedNode(XSD_DATE)));
-  yield quad(ds, namedNode(DCTERMS.identifier), literal(input.registerId));
-
-  for (const lang of input.languages ?? []) {
-    const langIri = `http://id.loc.gov/vocabulary/iso639-1/${lang}`;
-    yield quad(ds, namedNode(DCTERMS.language), namedNode(langIri));
-  }
-
-  for (const dist of input.distributions ?? []) {
-    yield* distributionToQuads(ds, dist);
-  }
-
-  for (const conceptUri of input.topConceptUris ?? []) {
-    yield quad(ds, namedNode(SKOS.hasTopConcept), namedNode(conceptUri));
-  }
-
-  if (input.sourceRepoUrl) {
-    yield quad(ds, namedNode(PROV.wasDerivedFrom), namedNode(input.sourceRepoUrl));
-  }
-  if (input.publisherIri) {
-    yield quad(ds, namedNode(DCTERMS.publisher), namedNode(input.publisherIri));
-  }
-  if (input.contactIri) {
-    yield quad(ds, namedNode(DCAT.contactPoint), namedNode(input.contactIri));
-  }
-
-  for (const section of input.sections ?? []) {
-    yield* sectionToQuads(section);
-  }
-}
-
-function* distributionToQuads(ds, dist) {
-  // Distributions are blank nodes — they don't have stable identity
-  // outside their parent dataset. Using blankNode() (not namedNode with
-  // a "_:..." string) so the n3 writer serializes them as _:bXXXX
-  // rather than <_:bXXXX> which would be an invalid IRI.
-  const distSubject = blankNode(`b${deterministicBnodeId('dist', dist.id, dist.downloadUrl)}`);
-  yield quad(ds, namedNode(DCAT.distribution), distSubject);
-  yield quad(distSubject, namedNode(RDF_TYPE), namedNode(DCAT.Distribution));
-  yield quad(distSubject, namedNode(DCTERMS.title), literal(dist.title));
-  yield quad(distSubject, namedNode(DCAT.mediaType), literal(dist.mediaType));
-  yield quad(distSubject, namedNode(DCAT.downloadURL), namedNode(dist.downloadUrl));
-  if (dist.byteSize != null) {
-    yield quad(distSubject, namedNode(DCAT.byteSize), literal(String(dist.byteSize), namedNode(XSD_INTEGER)));
-  }
-}
-
-function* sectionToQuads(section) {
-  const coll = namedNode(section.collectionIri);
-  yield quad(coll, namedNode(RDF_TYPE), namedNode(DCAT.Collection));
-  yield quad(coll, namedNode(DCTERMS.title), literal(section.title));
-  for (const member of section.memberUris ?? []) {
-    yield quad(coll, namedNode(SKOS.member), namedNode(member));
-  }
-  if (section.parentCollectionIri) {
-    yield quad(coll, namedNode(GLOSS.hasParentSection), namedNode(section.parentCollectionIri));
-  }
-  for (const child of section.childCollectionIris ?? []) {
-    yield quad(coll, namedNode(GLOSS.hasChildSection), namedNode(child));
-  }
-}
-
-// Local deterministic-id helper is no longer needed — using the shared
-// deterministicBnodeId from bnode-id.js for cross-emitter consistency.