glossarist 0.4.50 → 0.4.52

package/src/gcr-writer.ts

@@ -1,99 +0,0 @@
-import JSZip from 'jszip';
-import { conceptSerializer } from './concept-serializer.js';
-import { InvalidInputError } from './errors.js';
-import { compiledPath, isKnownFormat } from './compiled-format.js';
-import { GcrMetadata } from './models/gcr-metadata.js';
-import { GcrStatistics } from './models/gcr-statistics.js';
-
-export class GcrWriter {
-  static async createBuffer(options) {
-    if (!options || !options.concepts || typeof options.concepts[Symbol.iterator] !== 'function') {
-      throw new InvalidInputError(
-        'GcrWriter requires { concepts: Concept[] }',
-        'object with concepts array',
-      );
-    }
-
-    const zip = new JSZip();
-
-    if (options.metadata) {
-      const meta = GcrWriter._normalizeMetadata(options.metadata, options.concepts);
-      zip.file('metadata.yaml', conceptSerializer.toRegisterYaml(meta));
-    }
-    if (options.register) {
-      zip.file('register.yaml', conceptSerializer.toRegisterYaml(options.register));
-    }
-
-    for (const concept of options.concepts) {
-      const y = options.format === 'canonical'
-        ? conceptSerializer.toCanonicalYaml(concept)
-        : options.format === 'managed'
-          ? conceptSerializer.toManagedYaml(concept, options.uuidFn)
-          : conceptSerializer.toYaml(concept, options.uuidFn);
-      zip.file(`concepts/${concept.id}.yaml`, y);
-    }
-
-    if (options.compiledFormats) {
-      GcrWriter._writeCompiledFormats(zip, options.compiledFormats);
-    }
-
-    if (options.bibliography) {
-      const bib = options.bibliography;
-      const yamlStr = bib.toYAML ? bib.toYAML() : String(bib);
-      zip.file('bibliography.yaml', yamlStr);
-    }
-
-    if (options.images) {
-      GcrWriter._writeImages(zip, options.images);
-    }
-
-    return zip.generateAsync({ type: 'uint8array' });
-  }
-
-  static _normalizeMetadata(metadata, concepts) {
-    if (metadata instanceof GcrMetadata) {
-      const meta = metadata.clone();
-      if (!meta.statistics && concepts.length > 0) {
-        // @ts-expect-error TODO(Phase 2e): type this fully
-        meta.statistics = GcrStatistics.fromConcepts(concepts);
-      }
-      // @ts-expect-error TODO(Phase 2e): type this fully
-      if (!meta.conceptCount) meta.conceptCount = concepts.length;
-      return meta.toJSON();
-    }
-
-    const data = { ...metadata };
-    if (!data.statistics && concepts.length > 0) {
-      data.statistics = GcrStatistics.fromConcepts(concepts).toJSON();
-    }
-    if (!data.concept_count && concepts.length > 0) {
-      data.concept_count = concepts.length;
-    }
-    return data;
-  }
-
-  static _writeCompiledFormats(zip, compiledFormats) {
-    for (const [format, entries] of Object.entries(compiledFormats)) {
-      if (!isKnownFormat(format)) {
-        throw new RangeError(`Unknown compiled format: ${format}`);
-      }
-      // @ts-expect-error TODO(Phase 2e): type this fully
-      const map = entries instanceof Map ? entries : new Map(Object.entries(entries));
-      for (const [id, content] of map) {
-        zip.file(compiledPath(format, id), content);
-      }
-    }
-  }
-
-  static _writeImages(zip, images) {
-    const map = images instanceof Map ? images : new Map(Object.entries(images));
-    for (const [path, content] of map) {
-      const fullPath = path.startsWith('images/') ? path : `images/${path}`;
-      zip.file(fullPath, content);
-    }
-  }
-}
-
-export async function createGcr(concepts, metadata) {
-  return GcrWriter.createBuffer({ concepts, metadata });
-}

package/src/index.d.ts

@@ -1,124 +0,0 @@
-// Models
-export {
-  GlossaristModel,
-  RegistrableModel,
-  Concept, LocalizedConcept,
-  Designation, Expression, Abbreviation, Symbol, LetterSymbol, GraphicalSymbol,
-  Citation, ConceptRef, ConceptSource, RelatedConcept,
-  DesignationRelationship, ConceptReference, ConceptDate,
-  DetailedDefinition, NonVerbRep, NON_VERBAL_TYPES,
-  NonVerbalEntity, SharedNonVerbalEntity,
-  Figure, FigureImage, Table, Formula,
-  NonVerbalReference, FigureReference, TableReference, FormulaReference,
-  BibliographyEntry, BibliographyData,
-  GcrMetadata, GcrStatistics,
-  RELATIONSHIP_TYPES, DESIGNATION_RELATIONSHIP_TYPES, DATE_TYPES,
-  PartitiveHyperedge, PARTITIVE_ENUMERATION, PARTITIVE_ENUMERATION_VALUES,
-  PLURALITY_MARKER, PLURALITY_MARKER_VALUES,
-} from './models/index';
-
-// Concept diff
-export {
-  diffConcepts,
-  diffLocalizedConcepts,
-  diffText,
-  diffList,
-  diffSet,
-  ConceptDiff,
-  ConceptLevelDiff,
-  LocalizedConceptDiff,
-  MetadataDiff,
-  DiffStats,
-  ListDiff,
-  TextDiff,
-  TextHunk,
-  Change,
-  Added,
-  Removed,
-  Changed,
-} from './diff/index';
-
-// GCR reader
-export { loadGcr, GcrPackage, parseConceptYaml, naturalSort } from './gcr-reader';
-
-// GCR writer
-export { createGcr, GcrWriter } from './gcr-writer';
-
-// Concept reader
-export { readConcepts, readConcept, listConceptIds, readRegister } from './concept-reader';
-
-// Concept writer
-export { writeConcept, writeConcepts } from './concept-writer';
-
-// Collections
-export { ConceptCollection } from './concept-collection';
-export { ManagedConceptCollection } from './managed-concept-collection';
-
-// Validators
-export {
-  validateConcept, validateRegister, validateGcrPackage,
-  createConceptValidator,
-  ValidationError, ValidationRule, ValidationResult,
-  RegisterValidator, GcrValidator,
-  NonVerbalRefIntegrityRule, OrphanedImagesRule,
-} from './validators/index';
-export { AssetIndex } from './validators/asset-index';
-
-// UUID
-export { conceptUuid, localizedConceptUuid, uuidV5 } from './uuid';
-
-// Reference resolution
-export {
-  ReferenceResolver, Reference, referenceResolver,
-  resolveBibliographyRecord, findNonVerbalEntity,
-} from './reference-resolver';
-
-export type MentionParseResult = {
-  kind: 'cite-ref' | 'urn-ref' | 'fig-ref' | 'table-ref' | 'formula-ref'
-      | 'numeric' | 'designation' | 'unresolved';
-  key?: string;
-  uri?: string;
-  label?: string | null;
-  id?: string;
-  raw: string;
-};
-
-export function parseMention(raw: string): MentionParseResult;
-
-export function fetchLocalizedString(
-  hash: Record<string, string> | null,
-  lang: string,
-  fallback?: string,
-): string | null;
-export function localizedStringIsEmpty(hash: Record<string, string> | null): boolean;
-export function localizedStringIsPresent(hash: Record<string, string> | null): boolean;
-
-// V1 support
-export { V1Reader, migrateV1ToV2 } from './v1-reader';
-
-// Errors
-export { GlossaristError, InvalidInputError, YamlParseError } from './errors';
-
-// Compiled format registry
-export const COMPILED_EXTENSIONS: ReadonlyMap<string, string>;
-export const COMPILED_FORMATS: readonly string[];
-export function isKnownFormat(format: string): boolean;
-export function compiledFilename(format: string, id: string): string;
-export function compiledPath(format: string, id: string): string;
-export function parseCompiledPath(zipPath: string): { format: string; id: string } | null;
-
-// Dataset asset registry
-export const DATASET_ASSETS: readonly { path: string; type: string }[];
-export const FILE_ASSETS: readonly { path: string; type: string }[];
-export const DIRECTORY_ASSETS: readonly { path: string; type: string }[];
-export function findFileAsset(path: string): { path: string; type: string } | undefined;
-export function findDirectoryAssetPath(zipPath: string): { path: string; type: string } | undefined;
-export function isDatasetAssetPath(zipPath: string): boolean;
-
-// Entity directory registry
-export const ENTITY_DIRECTORIES: ReadonlyMap<string, string>;
-export const ENTITY_TYPES: readonly string[];
-export function entityDir(type: string): string;
-export function entityPath(type: string, id: string): string;
-export function isKnownEntityType(type: string): boolean;
-export function parseEntityPath(zipPath: string): { type: string; id: string } | null;

package/src/index.ts

@@ -1,92 +0,0 @@
-export { naturalSort } from './sort.js';
-export {
-  diffConcepts,
-  diffLocalizedConcepts,
-  diffText,
-  diffList,
-  diffSet,
-  ConceptDiff,
-  ConceptLevelDiff,
-  LocalizedConceptDiff,
-  MetadataDiff,
-  DiffStats,
-  ListDiff,
-  TextDiff,
-  TextHunk,
-  Change,
-  Added,
-  Removed,
-  Changed,
-} from './diff/index.js';
-export { loadGcr, GcrPackage, parseConceptYaml } from './gcr-reader.js';
-export { readConcepts, readConcept, listConceptIds, readRegister } from './concept-reader.js';
-export { writeConcept, writeConcepts } from './concept-writer.js';
-export { createGcr, GcrWriter } from './gcr-writer.js';
-export { ConceptCollection } from './concept-collection.js';
-export { ManagedConceptCollection } from './managed-concept-collection.js';
-export { validateConcept, validateRegister, validateGcrPackage, createConceptValidator, ValidationError, ValidationRule, ValidationResult, RegisterValidator, GcrValidator } from './validators/index.js';
-export { conceptUuid, localizedConceptUuid, uuidV5 } from './uuid.js';
-export { ReferenceResolver, Reference, referenceResolver, resolveBibliographyRecord, findNonVerbalEntity } from './reference-resolver.js';
-export { parseMention } from './reference-mention.js';
-export { ReferenceClassifier } from './render-classification.js';
-export { V1Reader, migrateV1ToV2 } from './v1-reader.js';
-export { GlossaristError, InvalidInputError, YamlParseError } from './errors.js';
-
-export {
-  COMPILED_EXTENSIONS,
-  COMPILED_FORMATS,
-  isKnownFormat,
-  compiledFilename,
-  compiledPath,
-  parseCompiledPath,
-} from './compiled-format.js';
-
-export {
-  DATASET_ASSETS,
-  FILE_ASSETS,
-  DIRECTORY_ASSETS,
-} from './dataset-asset.js';
-
-export {
-  GlossaristModel,
-  RegistrableModel,
-  Register, Section,
-  REGISTER_STATUSES, ORDERING_METHODS,
-  Concept, LocalizedConcept,
-  Designation, Expression, Abbreviation, Symbol, GraphicalSymbol,
-  Citation, ConceptRef, ConceptSource, RelatedConcept, DesignationRelationship, ConceptReference, ConceptDate,
-  DetailedDefinition, NonVerbRep, NON_VERBAL_TYPES,
-  NonVerbalEntity, SharedNonVerbalEntity,
-  Figure, FigureImage, Table, Formula,
-  NonVerbalReference, FigureReference, TableReference, FormulaReference,
-  BibliographyEntry, BibliographyData,
-  fetchLocalizedString, localizedStringIsEmpty, localizedStringIsPresent,
-  GcrMetadata, GcrStatistics,
-  RELATIONSHIP_TYPES, DESIGNATION_RELATIONSHIP_TYPES, DATE_TYPES,
-  PartitiveHyperedge,
-  PARTITIVE_ENUMERATION, PARTITIVE_ENUMERATION_VALUES,
-  PLURALITY_MARKER, PLURALITY_MARKER_VALUES,
-} from './models/index.js';
-
-export { AssetIndex } from './validators/asset-index.js';
-
-export {
-  ENTITY_DIRECTORIES,
-  ENTITY_TYPES,
-  entityDir,
-  entityPath,
-  isKnownEntityType,
-  parseEntityPath,
-} from './entity-directory.js';
-
-// RDF serialization layer (WS C). Mirrors lib/glossarist/rdf/.
-//
-// NOTE: RDF and transforms are intentionally NOT re-exported from the
-// main entry. They use Node-specific APIs (node:crypto for deterministic
-// IDs) and pulling them in here would break browser builds. Consumers
-// import them via the dedicated subpaths:
-//
-//   import { conceptToQuads, writeTurtle } from 'glossarist/rdf';
-//   import { ConceptToGlossTransform } from 'glossarist/transforms';
-//
-// Both subpaths are declared in package.json `exports`.

package/src/managed-concept-collection.ts

@@ -1,130 +0,0 @@
-import { ConceptCollection } from './concept-collection.js';
-import { readConcepts, readRegister } from './concept-reader.js';
-import { writeConcepts } from './concept-writer.js';
-import { loadGcr } from './gcr-reader.js';
-import { GcrWriter } from './gcr-writer.js';
-import { BibliographyData } from './models/bibliography-data.js';
-
-export class ManagedConceptCollection {
-  constructor() {
-    // @ts-expect-error TODO(Phase 2e): type this fully
-    this._concepts = new ConceptCollection();
-    // @ts-expect-error TODO(Phase 2e): type this fully
-    this._register = null;
-    // @ts-expect-error TODO(Phase 2e): type this fully
-    this._bibliography = null;
-    // @ts-expect-error TODO(Phase 2e): type this fully
-    this._images = null;
-  }
-
-  // @ts-expect-error TODO(Phase 2e): type this fully
-  get concepts() { return this._concepts; }
-  // @ts-expect-error TODO(Phase 2e): type this fully
-  get register() { return this._register; }
-  // @ts-expect-error TODO(Phase 2e): type this fully
-  get bibliography() { return this._bibliography; }
-  // @ts-expect-error TODO(Phase 2e): type this fully
-  get images() { return this._images; }
-
-  loadFromDirectory(dir) {
-    // @ts-expect-error TODO(Phase 2e): type this fully
-    this._concepts = new ConceptCollection(readConcepts(dir));
-    // @ts-expect-error TODO(Phase 2e): type this fully
-    this._register = readRegister(dir);
-    return this;
-  }
-
-  async loadFromGcr(input) {
-    const pkg = await loadGcr(input);
-    // @ts-expect-error TODO(Phase 2e): type this fully
-    this._concepts = new ConceptCollection(await pkg.allConcepts());
-    // @ts-expect-error TODO(Phase 2e): type this fully
-    this._register = await pkg.register();
-    // @ts-expect-error TODO(Phase 2e): type this fully
-    this._bibliography = await pkg.bibliography();
-    // @ts-expect-error TODO(Phase 2e): type this fully
-    this._images = await pkg.allImageFiles();
-    return this;
-  }
-
-  saveToDirectory(dir, options = {}) {
-    // @ts-expect-error TODO(Phase 2e): type this fully
-    writeConcepts(dir, this._concepts, {
-      // @ts-expect-error TODO(Phase 2e): type this fully
-      register: this._register ?? undefined,
-      // @ts-expect-error TODO(Phase 2e): type this fully
-      format: options.format,
-    });
-  }
-
-  async saveToGcr(options = {}) {
-    return GcrWriter.createBuffer({
-      // @ts-expect-error TODO(Phase 2e): type this fully
-      concepts: this._concepts,
-      // @ts-expect-error TODO(Phase 2e): type this fully
-      metadata: options.metadata,
-      // @ts-expect-error TODO(Phase 2e): type this fully
-      register: this._register,
-      // @ts-expect-error TODO(Phase 2e): type this fully
-      format: options.format,
-      // @ts-expect-error TODO(Phase 2e): type this fully
-      compiledFormats: options.compiledFormats,
-      // @ts-expect-error TODO(Phase 2e): type this fully
-      bibliography: this._bibliography,
-      // @ts-expect-error TODO(Phase 2e): type this fully
-      images: this._images,
-    });
-  }
-
-  add(concept) {
-    // @ts-expect-error TODO(Phase 2e): type this fully
-    const existing = this._concepts.byId(concept.id);
-    if (existing) {
-      // @ts-expect-error TODO(Phase 2e): type this fully
-      const idx = this._concepts.indexOf(existing);
-      // @ts-expect-error TODO(Phase 2e): type this fully
-      this._concepts.set(idx, concept);
-    } else {
-      // @ts-expect-error TODO(Phase 2e): type this fully
-      this._concepts.push(concept);
-    }
-    return this;
-  }
-
-  remove(id) {
-    // @ts-expect-error TODO(Phase 2e): type this fully
-    const idx = this._concepts.findIndex(c => c.id === id);
-    // @ts-expect-error TODO(Phase 2e): type this fully
-    if (idx >= 0) this._concepts.splice(idx, 1);
-    return this;
-  }
-
-  setRegister(data) {
-    // @ts-expect-error TODO(Phase 2e): type this fully
-    this._register = data;
-    return this;
-  }
-
-  setBibliography(bib) {
-    if (bib instanceof BibliographyData) {
-      // @ts-expect-error TODO(Phase 2e): type this fully
-      this._bibliography = bib;
-    } else if (typeof bib === 'string') {
-      // @ts-expect-error TODO(Phase 2e): type this fully
-      this._bibliography = BibliographyData.fromYAML(bib);
-    } else if (bib == null) {
-      // @ts-expect-error TODO(Phase 2e): type this fully
-      this._bibliography = null;
-    } else {
-      // @ts-expect-error TODO(Phase 2e): type this fully
-      this._bibliography = new BibliographyData(bib);
-    }
-    return this;
-  }
-
-  setImages(images) {
-    // @ts-expect-error TODO(Phase 2e): type this fully
-    this._images = images instanceof Map ? images : new Map(Object.entries(images));
-    return this;
-  }
-}

package/src/migration/hyperedge-migrator.ts

@@ -1,104 +0,0 @@
-// v1 → v2 PartitiveHyperedge migration.
-//
-// Pure function: takes a v1 PartitiveHyperedge hash, returns a v2
-// PartitiveHyperedge hash. Idempotent.
-
-export interface V1HyperedgeHash {
-  comprehensive?: { source?: string; id?: string; text?: string };
-  parts?: ReadonlyArray<{ source?: string; id?: string }>;
-  enumeration?: string;
-  content?: string | null;
-  markers?: ReadonlyArray<string>;
-}
-
-export interface V2HyperedgeHash {
-  comprehensive: { source?: string; id?: string };
-  partitives: ReadonlyArray<{
-    ref: { source?: string; id?: string };
-    presence: string;
-    count: string;
-  }>;
-  completeness: string;
-  migrationWarning?: string;
-}
-
-export function migrateHyperedgeToRelation(
-  v1Hash: V1HyperedgeHash | ReadonlyArray<V1HyperedgeHash> | null,
-): V2HyperedgeHash | ReadonlyArray<V2HyperedgeHash | null> | null {
-  if (v1Hash == null) return null;
-  if (Array.isArray(v1Hash)) {
-    return v1Hash.map(migrateHyperedgeToRelation) as ReadonlyArray<V2HyperedgeHash | null>;
-  }
-
-  const h = v1Hash as V1HyperedgeHash;
-  const out: Partial<V2HyperedgeHash> = {
-    comprehensive: { ...(h.comprehensive ?? {}) },
-  };
-
-  const parts = Array.isArray(h.parts) ? h.parts : [];
-  out.partitives = parts.map((ref) => ({
-    ref: { ...ref },
-    presence: 'required',
-    count: 'exactly_one',
-  }));
-
-  out.completeness = _migrateEnumeration(h.enumeration);
-
-  if (parts.length < 2) {
-    out.migrationWarning =
-      `v1 PartitiveHyperedge had ${parts.length} part(s); v2 requires ≥2. ` +
-      `Either add more partitives or convert to a binary has_part edge.`;
-  }
-
-  if (h.content != null) {
-    out.migrationWarning = (out.migrationWarning ?? '') +
-      ` v1 'content' field was dropped (v2 PartitiveHyperedge carries no prose; ` +
-      `move valuable text to the comprehensive concept's notes).`;
-  }
-
-  if (Array.isArray(h.markers) && h.markers.length > 0) {
-    out.migrationWarning = (out.migrationWarning ?? '') +
-      ` v1 'markers' field (${h.markers.join(', ')}) was dropped; ` +
-      `v2 uses per-member 'multiplicity' + 'is_delimiting'. Reviewer ` +
-      `should set these per partitive based on ISO 704:2022 notation.`;
-  }
-
-  return out as V2HyperedgeHash;
-}
-
-export function downgradeRelationToHyperedge(
-  v2Hash: Partial<V2HyperedgeHash> | ReadonlyArray<Partial<V2HyperedgeHash>> | null,
-): unknown {
-  if (v2Hash == null) return null;
-  if (Array.isArray(v2Hash)) {
-    return v2Hash.map(downgradeRelationToHyperedge);
-  }
-
-  const v2 = v2Hash as V2HyperedgeHash;
-  const out: {
-    comprehensive: { source?: string; id?: string };
-    parts: Array<{ source?: string; id?: string }>;
-    enumeration: string;
-  } = {
-    comprehensive: { ...(v2.comprehensive ?? {}) },
-    parts: [],
-    enumeration: '',
-  };
-
-  out.parts = (v2.partitives ?? []).map((m) => ({ ...(m.ref ?? {}) }));
-  out.enumeration = _downgradeCompleteness(v2.completeness);
-
-  return out;
-}
-
-function _migrateEnumeration(value: string | undefined): string {
-  if (value === 'open') return 'partial';
-  if (value === 'closed') return 'complete';
-  if (value == null) return 'complete';
-  return 'complete';
-}
-
-function _downgradeCompleteness(value: string | undefined): string {
-  if (value === 'partial') return 'open';
-  return 'closed';
-}