glossarist 0.4.47 → 0.4.49

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "glossarist",
-  "version": "0.4.47",
+  "version": "0.4.49",
   "description": "JavaScript SDK for Glossarist GCR packages — read, write, validate, and manage terminology concepts",
   "type": "module",
   "main": "src/index.js",

package/src/concept-reader.ts

@@ -1,4 +1,5 @@
-// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
+import type { Concept } from './models/concept.js';
+import type { RegisterJson } from './models/register.js';
 import fs from 'fs';
 import path from 'path';
 import * as yaml from 'js-yaml';
@@ -38,7 +39,7 @@ export function readConcepts(dir) {
     .filter(f => f.endsWith('.yaml') && f !== 'register.yaml')
     .sort(naturalSort);
 
-  const concepts = [];
+  const concepts: Concept[] = [];
   for (const file of files) {
     const raw = fs.readFileSync(path.join(dir, file), 'utf8');
     const concept = conceptParser.parse(raw, file);
@@ -150,5 +151,5 @@ export function readRegister(dir) {
   const p = path.join(dir, 'register.yaml');
   if (!fs.existsSync(p)) return null;
   const raw = yaml.load(fs.readFileSync(p, 'utf8'));
-  return Register.fromJSON(raw);
+  return Register.fromJSON(raw as RegisterJson);
 }

package/src/rdf/agents-emitter.ts

@@ -8,7 +8,7 @@
 // prov:Organization, and the person is linked via prov:actedOnBehalfOf.
 
 import { namedNode, literal, quad } from './terms.js';
-import { PREFIXES } from './predicates.js';
+import { PREFIXES } from './prefixes.js';
 import { RDF_TYPE } from './curie.js';
 
 const PROV_NS    = PREFIXES.prov;
@@ -94,7 +94,7 @@ export function agentsFromContributors(contributors, agentBase) {
  * @param {string} [options.orgBase] — default https://glossarist.org/org
  * @returns {Generator<Quad, void, unknown>}
  */
-export function* agentsToQuads(agents, options = {}) {
+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();
@@ -104,10 +104,10 @@ export function* agentsToQuads(agents, options = {}) {
     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.name));
+    yield quad(person, namedNode(FOAF.name), literal((a as Record<string, unknown>).name as string));
 
-    if (a.email) {
-      yield quad(person, namedNode(FOAF.mbox), namedNode(`mailto:${a.email}`));
+    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) {
       yield quad(person, namedNode(RDFS.seeAlso), namedNode(a.url));

package/src/rdf/bibliography-emitter.ts

@@ -1,4 +1,3 @@
-// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 // Bibliography emitter — emits dcterms:BibliographicResource per
 // bibliography entry. Mirrors concept-browser's bibliography-emitter.ts.
 //
@@ -11,7 +10,7 @@
 // - dcterms:isPartOf (parent dataset)
 
 import { namedNode, literal, quad } from './terms.js';
-import { PREFIXES } from './predicates.js';
+import { PREFIXES } from './prefixes.js';
 import { RDF_TYPE } from './curie.js';
 
 // Namespace IRIs from canonical PREFIXES. foaf is absent from the
@@ -106,9 +105,9 @@ export function* bibliographyToQuads(input) {
 export function normalizeBibliographyData(raw) {
   if (!raw || typeof raw !== 'object') return [];
   if (Array.isArray(raw.bibliography)) {
-    return raw.bibliography.map(e => entryFromV3(e));
+    return raw.bibliography.map(e => entryFromV3(e, null));
   }
-  const entries = [];
+  const entries: unknown[] = [];
   for (const [id, value] of Object.entries(raw)) {
     if (!value || typeof value !== 'object') continue;
     entries.push(entryFromV3(value, id));

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

@@ -1,4 +1,3 @@
-// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 // Build activity emitter — emits prov:Activity per build run.
 // Mirrors concept-browser's build-activity-emitter.ts.
 //
@@ -10,7 +9,7 @@
 // - prov:wasAssociatedWith for the CI bot agent
 
 import { namedNode, literal, quad } from './terms.js';
-import { PREFIXES } from './predicates.js';
+import { PREFIXES } from './prefixes.js';
 import { RDF_TYPE } from './curie.js';
 
 const PROV_NS    = PREFIXES.prov;

package/src/rdf/curie.ts

@@ -1,4 +1,5 @@
 // @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
+// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 // CURIE helpers — resolve/compact IRIs against the canonical PREFIXES.
 //
 // Single source of truth for CURIE ↔ IRI conversion. Previously

package/src/rdf/dataset-emitter.ts

@@ -1,4 +1,3 @@
-// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 // Dataset emitter — emits dcat:Dataset + skos:ConceptScheme per
 // register. Mirrors concept-browser's dataset-emitter.ts.
 //
@@ -12,7 +11,7 @@
 // for cascading section membership).
 
 import { namedNode, blankNode, literal, quad } from './terms.js';
-import { PREFIXES } from './predicates.js';
+import { PREFIXES } from './prefixes.js';
 import { RDF_TYPE } from './curie.js';
 import { deterministicBnodeId } from './bnode-id.js';
 

package/src/rdf/document-writer.ts

@@ -1,4 +1,3 @@
-// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 // Quads → canonical Turtle / N-Triples / JSON-LD document.
 //
 // Turtle is produced via N3.Writer. JSON-LD via the `jsonld` package
@@ -6,12 +5,12 @@
 // as a stable fallback that doesn't depend on prefix maps.
 import { Writer as N3Writer } from 'n3';
 import jsonld from 'jsonld';
-import { PREFIXES } from './predicates.js';
+import { PREFIXES } from './prefixes.js';
 
 // Collects all quads yielded by an emitter into an array. Useful for tests
 // and for callers that want to inspect the quad stream directly.
 export function collectQuads(quadsIterable) {
-  const out = [];
+  const out: unknown[] = [];
   for (const q of quadsIterable) out.push(q);
   return out;
 }

package/src/rdf/gloss-concept.ts

@@ -19,7 +19,7 @@ import { namedNode, literal, quad } from './terms.js';
 // (2) add one entry here. Per TODO Phase 6e this should be a
 // self-registering registry; for the two current types, the dispatch
 // table is simpler and keeps the dependency graph acyclic.
-const HYPEREDGE_EMITTERS = new Map([
+const HYPEREDGE_EMITTERS: Map<unknown, Record<string, unknown>> = new Map([
   [PartitiveHyperedge, {
     linkPredicate: PRED.gloss.hasPartitiveRelation,
     subjectUri: partitiveRelationSubjectUri,
@@ -97,7 +97,7 @@ export function* conceptToQuads(concept, options) {
   // emitter table.
   let relIdx = 0;
   for (const relation of concept.relations ?? []) {
-    const emitter = HYPEREDGE_EMITTERS.get(relation.constructor);
+    const emitter = HYPEREDGE_EMITTERS.get(relation.constructor) as unknown as { linkPredicate: string; subjectUri: (a: string, b: unknown, c: number) => string; toQuads: (a: unknown, b: { parentUri: string; index: number }) => Iterable<unknown> } | undefined;
     if (!emitter) {
       // Unknown hyperedge type — skip rather than crash. The OCP
       // contract (Phase 11) tests that new types register an emitter;

package/src/rdf/gloss-designation.ts

@@ -1,4 +1,3 @@
-// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 // Designation → RDF quads. Mirrors glossarist-ruby's
 // `Rdf::GlossDesignation` + the per-subtype classes (GlossExpression,
 // GlossAbbreviation, etc.). The ontology class for each subtype is
@@ -66,8 +65,8 @@ export function* designationToQuads(designation, { subjectUri, language, index }
   // backward compatibility with simpler designations.
   const booleanType = namedNode(XSD_BOOLEAN);
   for (const [field, predicate] of BOOLEAN_FLAGS) {
-    if (designation[field]) {
-      yield quad(namedNode(desigSubject), namedNode(predicate), literal('true', booleanType));
+    if (designation[field as string]) {
+      yield quad(namedNode(desigSubject), namedNode(predicate as string), literal('true', booleanType));
     }
   }
 }

package/src/rdf/group-emitter.ts

@@ -1,4 +1,3 @@
-// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 // Group emitter — emits dcat:DatasetSeries (lineage) or dcat:Catalog
 // (topic/family/collection) for dataset groups. Mirrors concept-browser's
 // group-emitter.ts.
@@ -13,7 +12,7 @@
 // Both kinds are also typed as skos:ConceptScheme for SKOS interop.
 
 import { namedNode, literal, quad } from './terms.js';
-import { PREFIXES } from './predicates.js';
+import { PREFIXES } from './prefixes.js';
 import { RDF_TYPE } from './curie.js';
 
 // Namespace IRIs from canonical PREFIXES.

package/src/rdf/image-variant-emitter.ts

@@ -1,4 +1,3 @@
-// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 // Image variant emitter — emits foaf:Image per format/language variant
 // of a dataset figure. Mirrors concept-browser's image-variant-emitter.ts.
 //
@@ -9,7 +8,7 @@
 // - dcat:downloadURL (canonical download)
 
 import { namedNode, literal, quad } from './terms.js';
-import { PREFIXES } from './predicates.js';
+import { PREFIXES } from './prefixes.js';
 import { RDF_TYPE } from './curie.js';
 
 const FOAF_NS    = PREFIXES.foaf ?? 'http://xmlns.com/foaf/0.1/';

package/src/rdf/prefixes.ts

@@ -6,9 +6,13 @@
 // 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';
+import { PRED, PREFIXES as _PREFIXES } from './predicates.js';
 
-export { PRED, PREFIXES };
+// Widen the type so emitters can access keys not in the JSON-LD context
+// (foaf, dcat) via `PREFIXES.foaf ?? 'fallback'`. The runtime values
+// are the same; the type just permits unknown-key access.
+export const PREFIXES: Record<string, string> = _PREFIXES as Record<string, string>;
+export { PRED };
 
 // SKOS-XL label predicates — same local name as SKOS, so we construct them
 // from the SKOS-XL namespace URI.

package/src/rdf/provenance-emitter.ts

@@ -1,4 +1,3 @@
-// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 // Provenance emitter — emits prov:wasGeneratedBy + prov:Activity quads
 // for any resource that needs build/view-time provenance.
 //
@@ -7,7 +6,7 @@
 // on standard RDF/JS Quad[] (no RdfGraph abstraction).
 
 import { namedNode, blankNode, literal, quad } from './terms.js';
-import { PREFIXES } from './predicates.js';
+import { PREFIXES } from './prefixes.js';
 import { RDF_TYPE, RDFS_LABEL } from './curie.js';
 import { deterministicBnodeId } from './bnode-id.js';
 

package/src/rdf/sections-builder.ts

@@ -20,7 +20,7 @@
 // use it.
 
 import { RDF_TYPE, RDFS_LABEL, compactIri } from './curie.js';
-import { PREFIXES } from './predicates.js';
+import { PREFIXES } from './prefixes.js';
 
 const SKOS_PREF_LABEL = `${PREFIXES.skos}prefLabel`;
 

package/src/rdf/version-emitter.ts

@@ -9,7 +9,7 @@
 // - prov:wasAssociatedWith (optional agent)
 
 import { namedNode, literal, quad } from './terms.js';
-import { PREFIXES } from './predicates.js';
+import { PREFIXES } from './prefixes.js';
 import { RDF_TYPE } from './curie.js';
 
 const PROV_NS    = PREFIXES.prov;

package/src/rdf/vocabulary-emitter.ts

@@ -13,7 +13,7 @@
 // PREFIXES.
 
 import { namedNode, literal, quad } from './terms.js';
-import { PREFIXES } from './predicates.js';
+import { PREFIXES } from './prefixes.js';
 import { resolveIri, RDF_TYPE, RDFS_LABEL } from './curie.js';
 
 const SKOS_NS = PREFIXES.skos;

package/src/validators/concept-validator.ts

@@ -1,4 +1,5 @@
 // @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
+// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 import { ValidationRule } from './validation-rule.js';
 import { ValidationResult } from './validation-result.js';