glossarist 0.4.46 → 0.4.48

package/package.json

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

package/src/compiled-format.ts

@@ -1,4 +1,3 @@
-// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 /**
  * Registry of compiled/machine formats that can be bundled inside a GCR package.
  *

package/src/concept-diff.ts

@@ -1,4 +1,3 @@
-// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 /**
  * @deprecated Import from `glossarist/diff` (i.e. `src/diff/index.js`)
  * instead. This file is a backwards-compatibility shim left over from

package/src/dataset-asset.ts

@@ -1,4 +1,3 @@
-// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 /**
  * Registry of dataset assets that can be bundled inside a GCR package.
  *

package/src/diff/collection-diff.ts

@@ -1,11 +1,11 @@
-// @ts-nocheck — TEMPORARY bridge during TS migration. TODO(Phase 2e): remove this directive and type all parameters.
+// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 import { GlossaristModel } from '../models/base.js';
 import { Added, Removed, Matched, deserializeChange } from './change.js';
 import { ConceptDiff, DiffStats, diffConcepts } from './concept-diff.js';
 import { averageSimilarity } from './similarity.js';
 
 export class ConceptCollectionDiff extends GlossaristModel {
-  constructor(data = {}) {
+  constructor(data: Record<string, unknown> = {}) {
     super();
     this.oldCount = data.oldCount ?? data.old_count ?? 0;
     this.newCount = data.newCount ?? data.new_count ?? 0;

package/src/diff/concept-diff.ts

@@ -1,4 +1,4 @@
-// @ts-nocheck — TEMPORARY bridge during TS migration. TODO(Phase 2e): remove this directive and type all parameters.
+// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 import { GlossaristModel } from '../models/base.js';
 import { PartitiveHyperedge } from '../models/partitive-hyperedge.js';
 import { GenericHyperedge } from '../models/generic-hyperedge.js';
@@ -33,7 +33,7 @@ const LOCALIZATION_METADATA_FIELDS = Object.freeze([
 // (See file-top comment about why they're duplicated rather than imported.)
 
 export class DiffStats extends GlossaristModel {
-  constructor(data = {}) {
+  constructor(data: Record<string, unknown> = {}) {
     super();
     this._added = data.added ?? 0;
     this._removed = data.removed ?? 0;
@@ -55,7 +55,7 @@ export class DiffStats extends GlossaristModel {
 }
 
 export class MetadataDiff extends GlossaristModel {
-  constructor(data = {}) {
+  constructor(data: Record<string, unknown> = {}) {
     super();
     this._changes = {};
     const raw = data.changes ?? data ?? {};
@@ -97,7 +97,7 @@ export class MetadataDiff extends GlossaristModel {
 }
 
 export class ConceptLevelDiff extends GlossaristModel {
-  constructor(data = {}) {
+  constructor(data: Record<string, unknown> = {}) {
     super();
     this._sources = wrapListDiff(data.sources);
     this._dates = wrapListDiff(data.dates);
@@ -193,7 +193,7 @@ export class ConceptLevelDiff extends GlossaristModel {
 }
 
 export class LocalizedConceptDiff extends GlossaristModel {
-  constructor(data = {}) {
+  constructor(data: Record<string, unknown> = {}) {
     super();
     this.languageCode = data.languageCode ?? data.language_code ?? null;
     this._designations = wrapListDiff(data.designations);
@@ -279,7 +279,7 @@ export class LocalizedConceptDiff extends GlossaristModel {
 }
 
 export class ConceptDiff extends GlossaristModel {
-  constructor(data = {}) {
+  constructor(data: Record<string, unknown> = {}) {
     super();
     this._oldId = data.oldId ?? data.old_id ?? null;
     this._newId = data.newId ?? data.new_id ?? null;

package/src/diff/diff-patch.ts

@@ -1,4 +1,4 @@
-// @ts-nocheck — TEMPORARY bridge during TS migration. TODO(Phase 2e): remove this directive and type all parameters.
+// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 import { Concept } from '../models/concept.js';
 import { ConceptSource } from '../models/concept-source.js';
 import { ConceptDate } from '../models/concept-date.js';

package/src/diff/diff-renderer.ts

@@ -1,4 +1,4 @@
-// @ts-nocheck — TEMPORARY bridge during TS migration. TODO(Phase 2e): remove this directive and type all parameters.
+// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 import { TextDiff } from './text-diff.js';
 import { resolveMultiplicity } from '../models/multiplicity.js';
 

package/src/diff/index.ts

@@ -1,4 +1,3 @@
-// @ts-nocheck — TEMPORARY bridge during TS migration. TODO(Phase 2e): remove this directive and type all parameters.
 export {
   TextHunk,
   TextDiff,

package/src/entity-directory.ts

@@ -1,4 +1,3 @@
-// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 const ENTITY_DIRECTORIES = Object.freeze(new Map([
   ['figure', 'figures'],
   ['table', 'tables'],

package/src/index.ts

@@ -1,4 +1,3 @@
-// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 export { naturalSort } from './sort.js';
 export {
   diffConcepts,

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;

package/src/rdf/bibliography-emitter.ts

@@ -11,7 +11,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

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,3 +1,4 @@
+// @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

@@ -6,7 +6,7 @@
 // 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.

package/src/rdf/gloss-detailed-definition.ts

@@ -1,4 +1,3 @@
-// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 // DetailedDefinition → RDF quads. Mirrors glossarist-ruby's
 // `Rdf::GlossDetailedDefinition`. Used for definitions, notes, examples,
 // and annotations — they all share the same shape (content + optional

package/src/rdf/gloss-generic-hyperedge.ts

@@ -1,4 +1,3 @@
-// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 // GenericHyperedge → RDF quads.
 //
 // Shape (mirrors gloss-partitive-relation.js, swapping partitive

package/src/rdf/gloss-localized-concept.ts

@@ -1,4 +1,3 @@
-// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 // LocalizedConcept → RDF quads. Mirrors glossarist-ruby's
 // `Rdf::GlossLocalizedConcept` + the `EmitsExtraTriples` hook.
 //

package/src/rdf/gloss-partitive-member.ts

@@ -1,4 +1,3 @@
-// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 // PartitiveMember → RDF quads.
 //
 // Emits per-member predicates (presence, count, is_delimiting,

package/src/rdf/gloss-partitive-relation.ts

@@ -1,4 +1,3 @@
-// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 // PartitiveHyperedge → RDF quads.
 //
 // Shape (per concept-model ontology, v3.2.0):

package/src/rdf/gloss-source.ts

@@ -1,4 +1,3 @@
-// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 // ConceptSource → RDF quads. Mirrors glossarist-ruby's
 // `Rdf::GlossConceptSource` + `Rdf::GlossCitation`. Sources are reified
 // resources linked from their parent (concept or localized concept or

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/index.ts

@@ -1,4 +1,3 @@
-// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 // Public RDF layer. Mirrors lib/glossarist/rdf/ in glossarist-ruby.
 export { PRED, PREFIXES, SKOSXL, WELL_KNOWN } from './prefixes.js';
 export {

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/shacl-entry.ts

@@ -1,4 +1,3 @@
-// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 // Node-only SHACL validator entry. Separated from glossarist/rdf so that
 // browser bundles can import RDF emitters/writers without pulling in
 // node:fs/promises, node:path, node:url.

package/src/rdf/version-emitter.ts

@@ -1,4 +1,3 @@
-// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 // Version emitter — emits prov:Entity version chain per dataset.
 // Mirrors concept-browser's version-emitter.ts.
 //
@@ -10,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

@@ -1,4 +1,3 @@
-// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 // Vocabulary graph emitter — emits SKOS ConceptSchemes for the
 // enumeration IRIs that glossarist emits in instance data
 // (gloss:status/*, gloss:entstatus/*, gloss:norm/*, gloss:srcstatus/*,
@@ -14,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/reference-mention.ts

@@ -1,4 +1,3 @@
-// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 /**
  * Mention parser for {{...}} inline references in concept text.
  *

package/src/validators/binary-has-part-redundancy-rule.ts

@@ -1,4 +1,3 @@
-// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 // Warns when binary `has_part` / `is_part_of` edges duplicate
 // PartitiveHyperedge members, or when a concept has many binary
 // has_part edges that should be consolidated into a PartitiveHyperedge.

package/src/validators/delimiting-coherence-rule.ts

@@ -1,4 +1,3 @@
-// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 // Validates delimiting coherence across a concept's PartitiveRelations
 // per ISO 704:2022.
 //

package/src/validators/external-concept-shape-rule.ts

@@ -1,4 +1,3 @@
-// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 // Validates ExternalConcept shape (status: external).
 //
 // Per TODO.partitive-relation-v2 item 06, an ExternalConcept is a

package/src/validators/hyperedge-coherence-rule.ts

@@ -1,4 +1,3 @@
-// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 // Validates hyperedge coherence per ISO 704 / ISO 12620.
 //
 // Applies to every AbstractHyperedge subclass (PartitiveHyperedge,

package/src/validators/index.ts

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

package/src/validators/partitive-relation-coherence-rule.ts

@@ -1,4 +1,3 @@
-// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 // Deprecated. This rule has been generalized and renamed to
 // HyperedgeCoherenceRule (see ./hyperedge-coherence-rule.js). The
 // new rule is type-blind — it validates every AbstractHyperedge

package/src/validators/ref-keys.ts

@@ -1,4 +1,3 @@
-// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 // Shared identity-key helpers for cross-relation validators.
 //
 // Extracted from HyperedgeCoherenceRule and

package/src/validators/register-validator.ts

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

package/src/validators/relationship-type-rule.ts

@@ -1,4 +1,3 @@
-// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 import { ValidationRule } from './validation-rule.js';
 import { RELATIONSHIP_TYPES } from '../models/related-concept.js';
 import { DESIGNATION_RELATIONSHIP_TYPES } from '../models/designation-relationship.js';

package/src/validators/sourced-from-locality-rule.ts

@@ -1,4 +1,3 @@
-// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 // Validates that every ConceptSource#sourced_from Citation includes a
 // locality. Per concept-model commit 9c065df ("sourced_from citations
 // must include locality"), a sourced_from entry without a locality is