glossarist 0.4.50 → 0.4.52

package/src/models/concept-source.ts

@@ -1,96 +0,0 @@
-import { GlossaristModel } from './base.js';
-import { Citation } from './citation.js';
-
-/**
- * Local Citation wire-shape alias. Until `citation.ts` lands (Phase
- * 2b), Citation is untyped JS; this alias gives the cross-references
- * a typed shape without forcing the conversion order. When
- * `citation.ts` exports its own `CitationJson`, replace this with
- * `import type { CitationJson } from './citation.js'`.
- */
-export interface CitationJson {
-  ref?: { source?: string | null; id?: string | null; text?: string | null } | null;
-}
-
-export interface ConceptSourceJson {
-  id?: string | null;
-  status?: string | null;
-  type?: string | null;
-  origin?: CitationJson | Citation | null;
-  modification?: string | null;
-  sourcedFrom?: ReadonlyArray<CitationJson | Citation> | null;
-  sourced_from?: ReadonlyArray<CitationJson | Citation> | null;
-}
-
-export class ConceptSource extends GlossaristModel {
-  readonly id: string | null;
-  readonly status: string | null;
-  readonly type: string | null;
-  readonly origin: Citation | null;
-  readonly modification: string | null;
-  readonly sourcedFrom: ReadonlyArray<Citation>;
-
-  constructor(data: ConceptSourceJson = {}) {
-    super();
-    this.id = data.id ?? null;
-    this.status = data.status ?? null;
-    this.type = data.type ?? null;
-    this.origin = data.origin
-      ? data.origin instanceof Citation
-        ? data.origin
-        : new Citation(data.origin)
-      : null;
-    this.modification = data.modification ?? null;
-    const sourcedRaw = data.sourcedFrom ?? data.sourced_from ?? [];
-    this.sourcedFrom = sourcedRaw.map((c) =>
-      c instanceof Citation ? c : new Citation(c),
-    );
-  }
-
-  /**
-   * Backward-compat alias for callers using the snake_case JS field
-   * name. Prefer `.sourcedFrom` going forward; the wire name remains
-   * `sourced_from` (see toJSON).
-   */
-  get sourced_from(): ReadonlyArray<Citation> {
-    return this.sourcedFrom;
-  }
-
-  override toJSON(): ConceptSourceJson {
-    const obj: ConceptSourceJson = {};
-    if (this.id != null) obj.id = this.id;
-    if (this.status != null) obj.status = this.status;
-    if (this.type != null) obj.type = this.type;
-    if (this.origin != null) obj.origin = this.origin.toJSON();
-    if (this.modification != null) obj.modification = this.modification;
-    if (this.sourcedFrom.length > 0) {
-      obj.sourced_from = this.sourcedFrom.map((c) => c.toJSON());
-    }
-    return obj;
-  }
-
-  static identityOf(
-    value: {
-      type?: string | null;
-      origin?: CitationJson | Citation | { ref?: { source?: string; id?: string } | null } | null;
-    } | null | undefined,
-  ): string {
-    const v = value ?? {};
-    const origin = v.origin as CitationJson | Citation | { ref?: { source?: string; id?: string } | null } | null | undefined;
-    const ref =
-      origin instanceof Citation
-        ? origin.ref
-        : origin && typeof origin === 'object'
-          ? (origin as { ref?: { source?: string; id?: string } | null }).ref
-          : null;
-    return `${v.type ?? ''}|${ref?.source ?? ''}|${ref?.id ?? ''}`;
-  }
-
-  override identity(): string {
-    return ConceptSource.identityOf(this);
-  }
-
-  static override fromJSON(data: ConceptSourceJson): ConceptSource {
-    return new ConceptSource(data);
-  }
-}

package/src/models/concept-system-type.ts

@@ -1,39 +0,0 @@
-// ConceptSystemType — ISO 12620 A.7.1 concept system type enum.
-//
-// Permissible instances per ISO 12620:
-//   generic     — species are part of the extension of the genus
-//   partitive   — based on whole-part relations
-//   sequential  — based on spatial and temporal relations
-//   associative — based on thematic or pragmatic relations
-//   mixed       — two or more of the above (the realistic case)
-
-export type ConceptSystemType =
-  | 'generic'
-  | 'partitive'
-  | 'sequential'
-  | 'associative'
-  | 'mixed';
-
-export const CONCEPT_SYSTEM_TYPE: Readonly<
-  Record<'GENERIC' | 'PARTITIVE' | 'SEQUENTIAL' | 'ASSOCIATIVE' | 'MIXED', ConceptSystemType>
-> = Object.freeze({
-  GENERIC: 'generic',
-  PARTITIVE: 'partitive',
-  SEQUENTIAL: 'sequential',
-  ASSOCIATIVE: 'associative',
-  MIXED: 'mixed',
-});
-
-export const CONCEPT_SYSTEM_TYPE_VALUES: ReadonlyArray<ConceptSystemType> =
-  Object.freeze(Object.values(CONCEPT_SYSTEM_TYPE));
-
-export function isValidConceptSystemType(
-  value: unknown,
-): value is ConceptSystemType {
-  return (
-    typeof value === 'string' &&
-    (CONCEPT_SYSTEM_TYPE_VALUES as readonly string[]).includes(value)
-  );
-}
-
-export default CONCEPT_SYSTEM_TYPE;

package/src/models/concept-system.ts

@@ -1,152 +0,0 @@
-// ConceptSystem — first-class concept system entity per ISO 12620 A.7.
-//
-// Promotes the previously-implicit concept system (domains + tags +
-// relation graph) to an explicit first-class entity. Per-file at
-// `concept-systems/<id>.yaml`.
-//
-// See docs/design/concept-systems.md (concept-model repo).
-
-import { GlossaristModel } from './base.js';
-import { ConceptRef } from './concept-ref.js';
-import {
-  CONCEPT_SYSTEM_TYPE,
-  CONCEPT_SYSTEM_TYPE_VALUES,
-  isValidConceptSystemType,
-} from './concept-system-type.js';
-import type { LocalizedString } from './generic-member.js';
-
-export interface ConceptSystemJson {
-  id: string;
-  name: LocalizedString;
-  type: string;
-  domain?: string | null;
-  purpose?: LocalizedString | null;
-  members: ReadonlyArray<unknown>;
-  hyperedges?: ReadonlyArray<unknown>;
-  rootConcepts?: ReadonlyArray<unknown>;
-  sources?: ReadonlyArray<unknown>;
-  status?: string | null;
-}
-
-export type ConceptSystemType = string;
-
-export class ConceptSystem extends GlossaristModel {
-  readonly id: string;
-  readonly name: LocalizedString;
-  readonly type: ConceptSystemType;
-  readonly domain: string | null;
-  readonly purpose: LocalizedString | null;
-  readonly members: ReadonlyArray<ConceptRef>;
-  readonly hyperedges: ReadonlyArray<unknown>;
-  readonly rootConcepts: ReadonlyArray<ConceptRef>;
-  readonly sources: ReadonlyArray<unknown>;
-  readonly status: string | null;
-
-  constructor(data: Partial<ConceptSystemJson> = {}) {
-    super();
-    this.id = _ensureNonEmptyString(data.id, 'id');
-    this.name = _ensureName(data.name);
-    this.type = _resolveType(data.type);
-    this.domain = data.domain ?? null;
-    this.purpose = data.purpose ?? null;
-    this.members = _ensureMembers(data.members);
-    this.hyperedges = Array.isArray(data.hyperedges) ? [...data.hyperedges] : [];
-    this.rootConcepts = Array.isArray(data.rootConcepts)
-      ? data.rootConcepts.map((c) =>
-          c instanceof ConceptRef ? c : new ConceptRef(c as { source?: string; id?: string; text?: string }),
-        )
-      : [];
-    this.sources = Array.isArray(data.sources) ? [...data.sources] : [];
-    this.status = data.status ?? null;
-  }
-
-  get isGeneric(): boolean     { return this.type === CONCEPT_SYSTEM_TYPE.GENERIC; }
-  get isPartitive(): boolean   { return this.type === CONCEPT_SYSTEM_TYPE.PARTITIVE; }
-  get isSequential(): boolean  { return this.type === CONCEPT_SYSTEM_TYPE.SEQUENTIAL; }
-  get isAssociative(): boolean { return this.type === CONCEPT_SYSTEM_TYPE.ASSOCIATIVE; }
-  get isMixed(): boolean       { return this.type === CONCEPT_SYSTEM_TYPE.MIXED; }
-
-  hasHyperedge(edgeId: string): boolean {
-    return (this.hyperedges as ReadonlyArray<string>).includes(edgeId);
-  }
-
-  hasMember(refOrUri: string | { source?: string | null; id?: string | null } | null | undefined): boolean {
-    const uri = typeof refOrUri === 'string' ? refOrUri : _refUri(refOrUri);
-    return this.members.some((m) => _refUri(m) === uri);
-  }
-
-  override identity(): string {
-    return this.id;
-  }
-
-  override toJSON(): ConceptSystemJson {
-    const obj: ConceptSystemJson = {
-      id: this.id,
-      name: { ...this.name },
-      type: this.type,
-      members: this.members.map((m) => m.toJSON()),
-    };
-    if (this.domain != null) obj.domain = this.domain;
-    if (this.purpose != null) obj.purpose = { ...this.purpose };
-    if (this.hyperedges.length > 0) obj.hyperedges = [...this.hyperedges];
-    if (this.rootConcepts.length > 0) obj.rootConcepts = this.rootConcepts.map((c) => c.toJSON());
-    if (this.sources.length > 0) obj.sources = [...this.sources];
-    if (this.status != null) obj.status = this.status;
-    return obj;
-  }
-
-  static override fromJSON(data: ConceptSystemJson): ConceptSystem {
-    return new ConceptSystem(data);
-  }
-}
-
-function _ensureNonEmptyString(value: unknown, fieldName: string): string {
-  if (typeof value !== 'string' || value.length === 0) {
-    throw new Error(`ConceptSystem#${fieldName} must be a non-empty string`);
-  }
-  return value;
-}
-
-function _ensureName(value: LocalizedString | null | undefined): LocalizedString {
-  if (value == null) return {};
-  if (typeof value !== 'object' || Array.isArray(value)) {
-    throw new Error('ConceptSystem#name must be a localized object (e.g. { eng: "..." })');
-  }
-  return { ...value };
-}
-
-function _resolveType(value: unknown): ConceptSystemType {
-  if (value == null) {
-    throw new Error(
-      'ConceptSystem#type is required; one of ' +
-      CONCEPT_SYSTEM_TYPE_VALUES.join(', '),
-    );
-  }
-  if (!isValidConceptSystemType(value)) {
-    throw new Error(
-      `ConceptSystem#type ${JSON.stringify(value)} invalid; ` +
-      `must be one of: ${CONCEPT_SYSTEM_TYPE_VALUES.join(', ')}`,
-    );
-  }
-  return value;
-}
-
-function _ensureMembers(values: ReadonlyArray<unknown> | null | undefined): ReadonlyArray<ConceptRef> {
-  if (!Array.isArray(values) || values.length === 0) {
-    throw new Error('ConceptSystem#members must be a non-empty array');
-  }
-  return values.map((v) =>
-    v instanceof ConceptRef
-      ? v
-      : new ConceptRef(v as { source?: string; id?: string; text?: string }),
-  );
-}
-
-function _refUri(
-  ref: { ref?: { source?: string | null; id?: string | null } | null; source?: string | null; id?: string | null } | null | undefined,
-): string {
-  const inner = ref?.ref ?? ref ?? {};
-  return `${inner.source ?? ''}:${inner.id ?? ''}`;
-}
-
-export default ConceptSystem;