glossarist 0.4.42 → 0.4.44

package/src/rdf/{bnode-id.js → bnode-id.ts}

@@ -1,3 +1,4 @@
+// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 // Deterministic blank node ID strategy.
 //
 // Single source of truth for bnode IDs across all emitters. Previously

package/src/rdf/{build-activity-emitter.js → build-activity-emitter.ts}

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

package/src/rdf/{curie.js → 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.js → dataset-emitter.ts}

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

package/src/rdf/{deterministic-id.js → deterministic-id.ts}

@@ -1,3 +1,4 @@
+// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 // Stable ID helpers for RDF emission. Mirrors glossarist-ruby's
 // Digest::MD5.hexdigest(content)[0..11] for cross-runtime stability.
 //

package/src/rdf/{document-writer.js → document-writer.ts}

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

package/src/rdf/{gloss-concept.js → gloss-concept.ts}

@@ -1,3 +1,4 @@
+// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 // Concept → RDF quads. Mirrors glossarist-ruby's `Rdf::GlossConcept`.
 //
 // URI shape: `<uriBase>/<registerId>/concept/<conceptId>`.

package/src/rdf/{gloss-designation.js → gloss-designation.ts}

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

package/src/rdf/{gloss-detailed-definition.js → gloss-detailed-definition.ts}

@@ -1,3 +1,4 @@
+// @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.js → gloss-generic-hyperedge.ts}

@@ -1,3 +1,4 @@
+// @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.js → gloss-localized-concept.ts}

@@ -1,3 +1,4 @@
+// @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-non-verbal-rep.js → gloss-non-verbal-rep.ts}

@@ -1,3 +1,4 @@
+// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 // NonVerbal entity → RDF quads. Mirrors the v3.1.0 concept-model
 // NonVerbal class hierarchy. Two distinct shapes:
 //

package/src/rdf/{gloss-partitive-member.js → gloss-partitive-member.ts}

@@ -1,3 +1,4 @@
+// @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.js → gloss-partitive-relation.ts}

@@ -1,3 +1,4 @@
+// @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.js → gloss-source.ts}

@@ -1,3 +1,4 @@
+// @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.js → group-emitter.ts}

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

package/src/rdf/{image-variant-emitter.js → image-variant-emitter.ts}

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

package/src/rdf/{index.js → index.ts}

@@ -1,3 +1,4 @@
+// @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/{normalize-enum.js → normalize-enum.ts}

@@ -1,3 +1,4 @@
+// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 // Helpers for normalizing enumeration values that get interpolated into
 // URIs. Source data may contain compound forms ("preferred/admitted") or
 // path-like values that must be reduced to a single local name before

package/src/rdf/{prefixes.js → prefixes.ts}

@@ -1,3 +1,4 @@
+// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 // 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.

package/src/rdf/{provenance-emitter.js → provenance-emitter.ts}

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

package/src/rdf/{sections-builder.js → sections-builder.ts}

@@ -1,3 +1,4 @@
+// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 // Sections builder — transforms a Quad[] into the ClassInstance[]
 // shape consumed by Vue UI components (RdfInstanceSection,
 // RdfInstanceHeader, RdfSourcePanel).

package/src/rdf/{shacl-entry.js → shacl-entry.ts}

@@ -1,3 +1,4 @@
+// @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/{shacl.js → shacl.ts}

@@ -1,3 +1,4 @@
+// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 // 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`.

package/src/rdf/{terms.js → terms.ts}

@@ -1,3 +1,4 @@
+// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 // Shared RDF/JS term constructors. Replaces the per-emitter
 // `const { namedNode, literal, quad } = DataFactory;` pattern that was
 // repeated across the RDF layer.

package/src/rdf/{version-emitter.js → version-emitter.ts}

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

package/src/rdf/{vocabulary-emitter.js → vocabulary-emitter.ts}

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

package/src/rdf/{write-turtle-sync.js → write-turtle-sync.ts}

@@ -1,3 +1,4 @@
+// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 // Sync Turtle writer — produces Turtle from RDF/JS Quads without
 // n3's callback API. Designed for UI use cases (Vue computed, React
 // render) that need synchronous output.

package/src/{reference-mention.js → reference-mention.ts}

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

package/src/{reference-resolver.js → reference-resolver.ts}

@@ -1,3 +1,4 @@
+// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 import { ConceptRef } from './models/concept-ref.js';
 import { parseMention } from './reference-mention.js';
 

package/src/{render-classification.js → render-classification.ts}

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

package/src/{sort.js → sort.ts}

@@ -3,11 +3,8 @@ const DIGIT_RE = /^\d+$/;
 
 /**
  * Natural sort comparator for concept IDs like "3.1.1.1", "551-12-39".
- * @param {string} a
- * @param {string} b
- * @returns {number}
  */
-export function naturalSort(a, b) {
+export function naturalSort(a: string, b: string): number {
   const pa = a.match(NATURAL_SORT_RE) || [];
   const pb = b.match(NATURAL_SORT_RE) || [];
   for (let i = 0; i < Math.max(pa.length, pb.length); i++) {

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

@@ -0,0 +1,81 @@
+// ConceptToGlossTransform — converts a Concept model into RDF.
+//
+// Usage:
+//   const xform = new ConceptToGlossTransform({ registerId: 'iso-6709', uriBase: 'https://example.org' });
+//   const ttl = await xform.toTurtle(concept);
+
+import { conceptToQuads } from '../rdf/gloss-concept.js';
+import {
+  collectQuads,
+  writeTurtle,
+  writeNTriples,
+  writeJsonld,
+} from '../rdf/document-writer.js';
+
+type QuadLike = unknown;
+type ConceptLike = { registerId?: string; id?: string | number } & Record<string, unknown>;
+
+interface WriterEntry {
+  write: (quads: QuadLike[] | QuadLike, transform: ConceptToGlossTransform) => Promise<unknown>;
+}
+
+const WRITERS: Readonly<Record<string, WriterEntry>> = Object.freeze({
+  turtle:   { write: (quads) => writeTurtle(quads as QuadLike[]) },
+  ntriples: { write: (quads) => writeNTriples(quads as QuadLike[]) },
+  jsonld:   { write: (quads, t) => writeJsonld(quads as QuadLike[], t._jsonldOpts() as never) },
+});
+
+export class ConceptToGlossTransform {
+  readonly registerId: string | undefined;
+  readonly uriBase: string;
+  readonly jsonldContext: unknown;
+
+  constructor(options: { registerId?: string; uriBase?: string; jsonldContext?: unknown } = {}) {
+    this.registerId = options.registerId;
+    this.uriBase = (options.uriBase ?? '').replace(/\/+$/, '');
+    if (!this.uriBase) {
+      throw new Error(
+        'ConceptToGlossTransform requires options.uriBase — the deployment canonical URI root.',
+      );
+    }
+    this.jsonldContext = options.jsonldContext;
+  }
+
+  toTurtle(target: ConceptLike): Promise<unknown> { return this._serialize(target, 'turtle'); }
+  toTurtleAll(targets: Iterable<ConceptLike>): Promise<unknown> { return this._serialize(targets, 'turtle'); }
+  toJsonld(target: ConceptLike): Promise<unknown> { return this._serialize(target, 'jsonld'); }
+  toJsonldAll(targets: Iterable<ConceptLike>): Promise<unknown> { return this._serialize(targets, 'jsonld'); }
+  toNTriples(target: ConceptLike): Promise<unknown> { return this._serialize(target, 'ntriples'); }
+  toNTriplesAll(targets: Iterable<ConceptLike>): Promise<unknown> { return this._serialize(targets, 'ntriples'); }
+
+  async _serialize(target: ConceptLike | Iterable<ConceptLike>, format: string): Promise<unknown> {
+    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: ConceptLike | Iterable<ConceptLike>): QuadLike[] {
+    if (target && typeof (target as Iterable<ConceptLike>)[Symbol.iterator] === 'function') {
+      const quads: QuadLike[] = [];
+      for (const concept of target as Iterable<ConceptLike>) {
+        for (const q of conceptToQuads(concept as never, this._optsFor(concept))) {
+          quads.push(q);
+        }
+      }
+      return quads;
+    }
+    return collectQuads(conceptToQuads(target as never, this._optsFor(target as ConceptLike)));
+  }
+
+  _optsFor(concept: ConceptLike): { registerId: string; uriBase: string } {
+    return {
+      registerId: this.registerId ?? concept.registerId ?? 'glossary',
+      uriBase: this.uriBase,
+    };
+  }
+
+  _jsonldOpts(): { context?: unknown } {
+    return this.jsonldContext ? { context: this.jsonldContext } : {};
+  }
+}

package/src/{uuid.js → uuid.ts}

@@ -2,27 +2,31 @@ import { createHash } from 'crypto';
 
 const NAMESPACE_UUID = '6ba7b810-9dad-11d1-80b4-00c04fd430c8';
 
-export function uuidV5(namespace, name) {
+export function uuidV5(namespace: string, name: string): string {
   const ns = _parseUuid(namespace);
   const hash = createHash('sha1').update(ns).update(name, 'utf8').digest();
-  hash[6] = (hash[6] & 0x0f) | 0x50;
-  hash[8] = (hash[8] & 0x3f) | 0x80;
+  hash[6] = ((hash[6] ?? 0) & 0x0f) | 0x50;
+  hash[8] = ((hash[8] ?? 0) & 0x3f) | 0x80;
   return _formatUuid(hash);
 }
 
-export function conceptUuid(conceptId, namespace = NAMESPACE_UUID) {
+export function conceptUuid(conceptId: string, namespace: string = NAMESPACE_UUID): string {
   return uuidV5(namespace, conceptId);
 }
 
-export function localizedConceptUuid(conceptId, languageCode, namespace = NAMESPACE_UUID) {
+export function localizedConceptUuid(
+  conceptId: string,
+  languageCode: string,
+  namespace: string = NAMESPACE_UUID,
+): string {
   return uuidV5(namespace, `${conceptId}:${languageCode}`);
 }
 
-function _parseUuid(str) {
+function _parseUuid(str: string): Buffer {
   return Buffer.from(str.replace(/-/g, ''), 'hex');
 }
 
-function _formatUuid(hash) {
+function _formatUuid(hash: Buffer): string {
   const h = hash.toString('hex');
   return [h.slice(0, 8), h.slice(8, 12), h.slice(12, 16), h.slice(16, 20), h.slice(20, 32)].join('-');
 }

package/src/{v1-reader.js → v1-reader.ts}

@@ -1,3 +1,4 @@
+// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 import fs from 'fs';
 import path from 'path';
 import * as yaml from 'js-yaml';

package/src/validators/{asset-index.js → asset-index.ts}

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

package/src/validators/{binary-has-part-redundancy-rule.js → binary-has-part-redundancy-rule.ts}

@@ -1,3 +1,4 @@
+// @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/{concept-validator.js → concept-validator.ts}

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

package/src/validators/{delimiting-coherence-rule.js → delimiting-coherence-rule.ts}

@@ -1,3 +1,4 @@
+// @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.js → external-concept-shape-rule.ts}

@@ -1,3 +1,4 @@
+// @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/{gcr-validator.js → gcr-validator.ts}

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

package/src/validators/{hyperedge-coherence-rule.js → hyperedge-coherence-rule.ts}

@@ -1,3 +1,4 @@
+// @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.js → index.ts}

@@ -1,3 +1,4 @@
+// @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.js → partitive-relation-coherence-rule.ts}

@@ -1,3 +1,4 @@
+// @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.js → ref-keys.ts}

@@ -1,3 +1,4 @@
+// @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.js → register-validator.ts}

@@ -1,3 +1,4 @@
+// @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.js → relationship-type-rule.ts}

@@ -1,3 +1,4 @@
+// @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.js → sourced-from-locality-rule.ts}

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

package/src/validators/{v3-rules.js → v3-rules.ts}

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

package/src/validators/{validation-error.js → validation-error.ts}

@@ -1,3 +1,4 @@
+// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 export class ValidationError {
   constructor(path, message, severity = 'error') {
     this.path = path;

package/src/validators/{validation-result.js → validation-result.ts}

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

package/src/validators/{validation-rule.js → validation-rule.ts}

@@ -1,3 +1,4 @@
+// @ts-nocheck — TEMPORARY during TS migration. TODO(Phase 2e): remove and type fully.
 export class ValidationRule {
   constructor(name, severity = 'error') {
     this.name = name;

package/src/diff/change.js

@@ -1,139 +0,0 @@
-import { GlossaristModel } from '../models/base.js';
-import { TextDiff } from './text-diff.js';
-
-export const CHANGE_ADDED = 'added';
-export const CHANGE_REMOVED = 'removed';
-export const CHANGE_CHANGED = 'changed';
-export const CHANGE_MATCHED = 'matched';
-
-function serializeValue(v) {
-  if (v == null) return null;
-  if (v instanceof GlossaristModel) return v.toJSON();
-  if (Array.isArray(v)) return v.map(serializeValue);
-  if (typeof v === 'object') {
-    const out = {};
-    for (const [k, val] of Object.entries(v)) out[k] = serializeValue(val);
-    return out;
-  }
-  return v;
-}
-
-export class Change extends GlossaristModel {
-  constructor(data = {}) {
-    super();
-    this.path = data.path ?? null;
-  }
-
-  get type() {
-    throw new Error(`${this.constructor.name} must override type getter`);
-  }
-
-  static fromJSON(data) {
-    return deserializeChange(data);
-  }
-}
-
-export class Added extends Change {
-  constructor(data = {}) {
-    super(data);
-    this.value = data.value ?? null;
-  }
-
-  get type() { return CHANGE_ADDED; }
-
-  toJSON() {
-    const obj = { type: CHANGE_ADDED };
-    if (this.path != null) obj.path = this.path;
-    obj.value = serializeValue(this.value);
-    return obj;
-  }
-
-  static fromJSON(data) {
-    return new Added(data);
-  }
-}
-
-export class Removed extends Change {
-  constructor(data = {}) {
-    super(data);
-    this.value = data.value ?? null;
-  }
-
-  get type() { return CHANGE_REMOVED; }
-
-  toJSON() {
-    const obj = { type: CHANGE_REMOVED };
-    if (this.path != null) obj.path = this.path;
-    obj.value = serializeValue(this.value);
-    return obj;
-  }
-
-  static fromJSON(data) {
-    return new Removed(data);
-  }
-}
-
-export class Changed extends Change {
-  constructor(data = {}) {
-    super(data);
-    this.oldValue = data.oldValue ?? data.old_value ?? null;
-    this.newValue = data.newValue ?? data.new_value ?? null;
-    this._textDiff = data.textDiff ?? (data.text_diff ? TextDiff.fromJSON(data.text_diff) : null);
-  }
-
-  get type() { return CHANGE_CHANGED; }
-
-  get textDiff() {
-    return this._textDiff;
-  }
-
-  toJSON() {
-    const obj = { type: CHANGE_CHANGED };
-    if (this.path != null) obj.path = this.path;
-    obj.old_value = serializeValue(this.oldValue);
-    obj.new_value = serializeValue(this.newValue);
-    if (this._textDiff) obj.text_diff = this._textDiff.toJSON();
-    return obj;
-  }
-
-  static fromJSON(data) {
-    return new Changed(data);
-  }
-}
-
-// Matched is for set-membership records that exist in both sides of a
-// comparison but have no directionality — used by ConceptCollectionDiff
-// to track which concepts were paired by id, distinct from those that
-// were genuinely Added or Removed. Distinct from Added because the data
-// has a different semantic meaning; conflating them caused type drift
-// in round 1 (TODO.hyperedges-v2/08).
-export class Matched extends Change {
-  constructor(data = {}) {
-    super(data);
-    this.value = data.value ?? null;
-  }
-
-  get type() { return CHANGE_MATCHED; }
-
-  toJSON() {
-    const obj = { type: CHANGE_MATCHED };
-    if (this.path != null) obj.path = this.path;
-    obj.value = serializeValue(this.value);
-    return obj;
-  }
-
-  static fromJSON(data) {
-    return new Matched(data);
-  }
-}
-
-export function deserializeChange(data) {
-  switch (data?.type) {
-    case CHANGE_ADDED: return Added.fromJSON(data);
-    case CHANGE_REMOVED: return Removed.fromJSON(data);
-    case CHANGE_CHANGED: return Changed.fromJSON(data);
-    case CHANGE_MATCHED: return Matched.fromJSON(data);
-    default:
-      throw new Error(`Unknown change type: ${data?.type}`);
-  }
-}