glossarist 0.4.50 → 0.4.51

package/dist/validators/validation-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-error.d.ts","sourceRoot":"","sources":["../../src/validators/validation-error.ts"],"names":[],"mappings":"AAAA,qBAAa,eAAe;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;gBAE3B,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,OAAO,GAAG,SAAmB;IAMlF,QAAQ,IAAI,MAAM;IAIlB,MAAM,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE;CAG9D"}

package/dist/validators/validation-error.js

@@ -0,0 +1,17 @@
+export class ValidationError {
+    path;
+    message;
+    severity;
+    constructor(path, message, severity = 'error') {
+        this.path = path;
+        this.message = message;
+        this.severity = severity;
+    }
+    toString() {
+        return `[${this.severity.toUpperCase()}] ${this.path}: ${this.message}`;
+    }
+    toJSON() {
+        return { path: this.path, message: this.message, severity: this.severity };
+    }
+}
+//# sourceMappingURL=validation-error.js.map

package/dist/validators/validation-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-error.js","sourceRoot":"","sources":["../../src/validators/validation-error.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,eAAe;IACjB,IAAI,CAAS;IACb,OAAO,CAAS;IAChB,QAAQ,CAAsB;IAEvC,YAAY,IAAY,EAAE,OAAe,EAAE,WAAgC,OAAO;QAChF,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;IAC1E,CAAC;IAED,MAAM;QACJ,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC7E,CAAC;CACF"}

package/dist/validators/validation-result.d.ts

@@ -0,0 +1,17 @@
+import { ValidationError } from './validation-error.js';
+export declare class ValidationResult {
+    private readonly _issues;
+    constructor();
+    get valid(): boolean;
+    get errors(): ReadonlyArray<ValidationError>;
+    get warnings(): ReadonlyArray<ValidationError>;
+    addError(path: string, message?: string): this;
+    addWarning(path: string, message?: string): this;
+    merge(other: ValidationResult): this;
+    toJSON(): {
+        valid: boolean;
+        errors: unknown[];
+        warnings: unknown[];
+    };
+}
+//# sourceMappingURL=validation-result.d.ts.map

package/dist/validators/validation-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-result.d.ts","sourceRoot":"","sources":["../../src/validators/validation-result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;;IAIjD,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED,IAAI,MAAM,IAAI,aAAa,CAAC,eAAe,CAAC,CAE3C;IAED,IAAI,QAAQ,IAAI,aAAa,CAAC,eAAe,CAAC,CAE7C;IAED,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAS9C,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAShD,KAAK,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAOpC,MAAM,IAAI;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QAAC,QAAQ,EAAE,OAAO,EAAE,CAAA;KAAE;CAOrE"}

package/dist/validators/validation-result.js

@@ -0,0 +1,47 @@
+import { ValidationError } from './validation-error.js';
+export class ValidationResult {
+    _issues = [];
+    constructor() { }
+    get valid() {
+        return this._issues.filter(e => e.severity === 'error').length === 0;
+    }
+    get errors() {
+        return this._issues.filter(e => e.severity === 'error');
+    }
+    get warnings() {
+        return this._issues.filter(e => e.severity === 'warning');
+    }
+    addError(path, message) {
+        if (message === undefined) {
+            this._issues.push(new ValidationError('', path, 'error'));
+        }
+        else {
+            this._issues.push(new ValidationError(path, message, 'error'));
+        }
+        return this;
+    }
+    addWarning(path, message) {
+        if (message === undefined) {
+            this._issues.push(new ValidationError('', path, 'warning'));
+        }
+        else {
+            this._issues.push(new ValidationError(path, message, 'warning'));
+        }
+        return this;
+    }
+    merge(other) {
+        if (other instanceof ValidationResult) {
+            for (const issue of other._issues)
+                this._issues.push(issue);
+        }
+        return this;
+    }
+    toJSON() {
+        return {
+            valid: this.valid,
+            errors: this.errors.map(e => typeof e.toJSON === 'function' ? e.toJSON() : e),
+            warnings: this.warnings.map(e => typeof e.toJSON === 'function' ? e.toJSON() : e),
+        };
+    }
+}
+//# sourceMappingURL=validation-result.js.map

package/dist/validators/validation-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-result.js","sourceRoot":"","sources":["../../src/validators/validation-result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,OAAO,gBAAgB;IACV,OAAO,GAAsB,EAAE,CAAC;IAEjD,gBAAe,CAAC;IAEhB,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;IACvE,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC;IAC5D,CAAC;IAED,QAAQ,CAAC,IAAY,EAAE,OAAgB;QACrC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,eAAe,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;QAC5D,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,UAAU,CAAC,IAAY,EAAE,OAAgB;QACvC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,eAAe,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;QAC9D,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,KAAuB;QAC3B,IAAI,KAAK,YAAY,gBAAgB,EAAE,CAAC;YACtC,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,OAAO;gBAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM;QACJ,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7E,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;SAClF,CAAC;IACJ,CAAC;CACF"}

package/dist/validators/validation-rule.d.ts

@@ -0,0 +1,10 @@
+import type { ValidationResult } from './validation-result.js';
+import type { Concept } from '../models/concept.js';
+export declare abstract class ValidationRule {
+    readonly name: string;
+    readonly severity: 'error' | 'warning';
+    constructor(name: string, severity?: 'error' | 'warning');
+    abstract validate(concept: Concept, path: string, result: ValidationResult): void;
+    addIssue(result: ValidationResult, path: string, message: string): void;
+}
+//# sourceMappingURL=validation-rule.d.ts.map

package/dist/validators/validation-rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-rule.d.ts","sourceRoot":"","sources":["../../src/validators/validation-rule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD,8BAAsB,cAAc;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;gBAE3B,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,OAAO,GAAG,SAAmB;IAKjE,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAEjF,QAAQ,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;CAOxE"}

package/dist/validators/validation-rule.js

@@ -0,0 +1,17 @@
+export class ValidationRule {
+    name;
+    severity;
+    constructor(name, severity = 'error') {
+        this.name = name;
+        this.severity = severity;
+    }
+    addIssue(result, path, message) {
+        if (this.severity === 'warning') {
+            result.addWarning(path, message);
+        }
+        else {
+            result.addError(path, message);
+        }
+    }
+}
+//# sourceMappingURL=validation-rule.js.map

package/dist/validators/validation-rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-rule.js","sourceRoot":"","sources":["../../src/validators/validation-rule.ts"],"names":[],"mappings":"AAGA,MAAM,OAAgB,cAAc;IACzB,IAAI,CAAS;IACb,QAAQ,CAAsB;IAEvC,YAAY,IAAY,EAAE,WAAgC,OAAO;QAC/D,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAID,QAAQ,CAAC,MAAwB,EAAE,IAAY,EAAE,OAAe;QAC9D,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;CACF"}

package/package.json

@@ -1,80 +1,72 @@
 {
   "name": "glossarist",
-  "version": "0.4.50",
+  "version": "0.4.51",
   "description": "JavaScript SDK for Glossarist GCR packages — read, write, validate, and manage terminology concepts",
   "type": "module",
-  "main": "src/index.js",
-  "types": "src/index.d.ts",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "sideEffects": false,
   "files": [
-    "src",
+    "dist",
     "data/concept-model/shapes/glossarist.shacl.ttl",
     "data/concept-model/README.md"
   ],
   "exports": {
     ".": {
-      "types": "./src/index.d.ts",
-      "import": "./src/index.js",
-      "default": "./src/index.js"
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
     },
     "./gcr": {
-      "types": "./src/gcr-reader.d.ts",
-      "import": "./src/gcr-reader.js",
-      "default": "./src/gcr-reader.js"
+      "types": "./dist/gcr-reader.d.ts",
+      "import": "./dist/gcr-reader.js"
     },
     "./concept": {
-      "types": "./src/concept-reader.d.ts",
-      "import": "./src/concept-reader.js",
-      "default": "./src/concept-reader.js"
+      "types": "./dist/concept-reader.d.ts",
+      "import": "./dist/concept-reader.js"
     },
     "./models": {
-      "types": "./src/models/index.d.ts",
-      "import": "./src/models/index.js",
-      "default": "./src/models/index.js"
+      "types": "./dist/models/index.d.ts",
+      "import": "./dist/models/index.js"
     },
     "./validators": {
-      "types": "./src/validators/index.d.ts",
-      "import": "./src/validators/index.js",
-      "default": "./src/validators/index.js"
+      "types": "./dist/validators/index.d.ts",
+      "import": "./dist/validators/index.js"
     },
     "./diff": {
-      "types": "./src/diff/index.d.ts",
-      "import": "./src/diff/index.js",
-      "default": "./src/diff/index.js"
+      "types": "./dist/diff/index.d.ts",
+      "import": "./dist/diff/index.js"
     },
     "./rdf": {
-      "types": "./src/rdf/index.d.ts",
-      "import": "./src/rdf/index.js",
-      "default": "./src/rdf/index.js"
+      "types": "./dist/rdf/index.d.ts",
+      "import": "./dist/rdf/index.js"
     },
     "./rdf/shacl": {
-      "types": "./src/rdf/shacl-entry.d.ts",
-      "import": "./src/rdf/shacl-entry.js",
-      "default": "./src/rdf/shacl-entry.js"
+      "types": "./dist/rdf/shacl-entry.d.ts",
+      "import": "./dist/rdf/shacl-entry.js"
     },
     "./rdf/prefixes": {
-      "types": "./src/rdf/predicates.d.ts",
-      "import": "./src/rdf/predicates.js",
-      "default": "./src/rdf/predicates.js"
+      "types": "./dist/rdf/predicates.d.ts",
+      "import": "./dist/rdf/predicates.js"
     },
     "./transforms": {
-      "types": "./src/transforms/index.d.ts",
-      "import": "./src/transforms/index.js",
-      "default": "./src/transforms/index.js"
-    }
+      "types": "./dist/transforms/index.d.ts",
+      "import": "./dist/transforms/index.js"
+    },
+    "./package.json": "./package.json"
   },
   "scripts": {
-    "lint": "eslint src/ test/",
-    "typecheck": "tsc --noEmit",
-    "build": "tsc",
-    "sync:model": "node scripts/sync-concept-model.mjs",
+    "build": "tsc -p tsconfig.build.json",
     "gen:predicates": "node scripts/gen-predicates.mjs",
+    "lint": "eslint src/ test/",
     "prebuild": "npm run gen:predicates",
-    "pretest": "node test/fixtures/build-fixtures.js",
+    "prepublishOnly": "npm run build && npm run typecheck && npm test",
+    "pretest": "node test/fixtures/build-fixtures.mjs",
+    "sync:model": "node scripts/sync-concept-model.mjs",
     "test": "find test \\( -name '*.test.js' -o -name '*.test.ts' \\) | sort | xargs node --import tsx --test",
-    "test:verbose": "find test \\( -name '*.test.js' -o -name '*.test.ts' \\) | sort | xargs node --import tsx --test --test-reporter spec",
     "test:coverage": "find test \\( -name '*.test.js' -o -name '*.test.ts' \\) | sort | xargs node --import tsx --test --experimental-test-coverage",
-    "prepublishOnly": "npm run typecheck && npm test"
+    "test:verbose": "find test \\( -name '*.test.js' -o -name '*.test.ts' \\) | sort | xargs node --import tsx --test --test-reporter spec",
+    "typecheck": "tsc --noEmit",
+    "typecheck:test": "tsc -p tsconfig.test.json --noEmit"
   },
   "keywords": [
     "glossarist",
@@ -111,8 +103,11 @@
   "devDependencies": {
     "@eslint/js": "^10.0.1",
     "@rdfjs/types": "^2.0.1",
+    "@types/jsonld": "^1.5.15",
     "@types/n3": "^1.26.1",
     "@types/node": "^26.1.2",
+    "@types/rdfjs__data-model": "^2.0.9",
+    "@types/rdfjs__dataset": "^2.0.7",
     "@typescript-eslint/eslint-plugin": "^8.65.0",
     "@typescript-eslint/parser": "^8.65.0",
     "eslint": "^10.3.0",

package/src/concept-collection.ts

@@ -1,172 +0,0 @@
-import { naturalSort } from './sort.js';
-
-const _items = Symbol('items');
-
-export class ConceptCollection {
-  constructor(concepts = []) {
-    this[_items] = Array.from(concepts);
-  }
-
-  get length() { return this[_items].length; }
-  [Symbol.iterator]() { return this[_items][Symbol.iterator](); }
-
-  at(index) { return this[_items].at(index); }
-  indexOf(item) { return this[_items].indexOf(item); }
-  find(fn) { return this[_items].find(fn); }
-  findIndex(fn) { return this[_items].findIndex(fn); }
-  forEach(fn) { this[_items].forEach(fn); }
-  map(fn) { return this[_items].map(fn); }
-  reduce(fn, init) { return this[_items].reduce(fn, init); }
-  includes(item) { return this[_items].includes(item); }
-  push(...items) { return this[_items].push(...items); }
-  splice(...args) { return this[_items].splice(...args); }
-  set(index, item) { this[_items][index] = item; }
-
-  toArray() { return [...this[_items]]; }
-
-  byId(id) {
-    return this[_items].find(c => c.id === id || c.termid === id);
-  }
-
-  /**
-   * Find a concept by id and version.
-   *
-   * The version is matched against a top-level `version` field on
-   * the concept instance (e.g. `concept.version`). The deployment
-   * is responsible for setting this field on bibliographic records;
-   * the data model does not enforce its presence or type.
-   *
-   * If `version` is null, the method falls back to `byId(id)`. This
-   * supports the "version-agnostic" lookup for datasets where
-   * version is not tracked.
-   *
-   * @param {string} id
-   * @param {string | null} version
-   * @returns {Concept | null}
-   */
-  byIdAnd(id, version) {
-    if (version == null) return this.byId(id);
-    return this[_items].find(c =>
-      (c.id === id || c.termid === id) && c.version === version
-    ) ?? null;
-  }
-
-  byPrefix(prefix) {
-    return new ConceptCollection(this[_items].filter(c => c.id.startsWith(prefix)));
-  }
-
-  byLanguage(lang) {
-    return new ConceptCollection(this[_items].filter(c => c.hasLocalization(lang)));
-  }
-
-  byStatus(status) {
-    return new ConceptCollection(this[_items].filter(c => {
-      return c.languages.some(lang => c.localization(lang)?.entryStatus === status);
-    }));
-  }
-
-  /**
-   * Cascading section membership filter. Returns concepts whose
-   * section closure includes `sectionId`.
-   *
-   * A concept in section "3.1.1" matches `bySection('3.1')` and
-   * `bySection('3')` because the section closure walks ancestors
-   * transitively (mirrors owl:TransitiveProperty on
-   * gloss:hasParentSection in the concept-model ontology).
-   *
-   * Two calling conventions:
-   *
-   *   bySection('3.1', { register })          // register expands each concept's section closure
-   *   bySection(['3.1', '3'])                  // pre-expanded target set (any of these must match)
-   *
-   * Concept-side membership is read from `concept.sections` if set,
-   * otherwise from `concept.groups` (a flat list of section IDs).
-   */
-  bySection(sectionId, options = {}) {
-    if (Array.isArray(sectionId)) {
-      const targetSet = new Set(sectionId);
-      return new ConceptCollection(this[_items].filter(c => {
-        // @ts-expect-error TODO(Phase 2e): type this fully
-        const ids = options.register
-          // @ts-expect-error TODO(Phase 2e): type this fully
-          ? options.register.conceptSectionIds(c)
-          : _flatConceptSectionIds(c);
-        return ids.some(id => targetSet.has(id));
-      }));
-    }
-    // @ts-expect-error TODO(Phase 2e): type this fully
-    if (!options.register) {
-      throw new Error('bySection(sectionId) requires { register } to expand the concept section closures');
-    }
-    const target = sectionId;
-    return new ConceptCollection(this[_items].filter(c => {
-      // @ts-expect-error TODO(Phase 2e): type this fully
-      const ids = options.register.conceptSectionIds(c);
-      return ids.includes(target);
-    }));
-  }
-
-  index() {
-    const map = new Map();
-    for (const c of this[_items]) map.set(c.id, c);
-    return map;
-  }
-
-  sorted() {
-    const copy = [...this[_items]];
-    copy.sort((a, b) => naturalSort(a.id, b.id));
-    // @ts-expect-error TODO(Phase 2e): type this fully
-    return new ConceptCollection(copy);
-  }
-
-  search(query) {
-    const q = query.toLowerCase();
-    return new ConceptCollection(this[_items].filter(c => {
-      for (const lang of c.languages) {
-        const lc = c.localization(lang);
-        if (!lc) continue;
-        for (const t of lc.terms) {
-          if ((t.designation ?? '').toLowerCase().includes(q)) return true;
-        }
-      }
-      for (const { text } of c.walkTexts()) {
-        if (text.toLowerCase().includes(q)) return true;
-      }
-      return false;
-    }));
-  }
-
-  allLanguages() {
-    const set = new Set();
-    for (const c of this[_items]) {
-      for (const lang of c.languages) set.add(lang);
-    }
-    return [...set].sort();
-  }
-
-  filter(fn) { return new ConceptCollection(this[_items].filter(fn)); }
-  slice(...args) { return new ConceptCollection(this[_items].slice(...args)); }
-  concat(...args) { return new ConceptCollection(this[_items].concat(...args)); }
-}
-
-// Standalone helper for the array-closure case where no register is
-// available. Mirrors the lookup done inside Register#conceptSectionIds
-// but without ancestor expansion (the closure is already provided).
-function _flatConceptSectionIds(concept) {
-  if (!concept) return [];
-  const out = [];
-  for (const source of [concept.sections, concept.groups]) {
-    if (!Array.isArray(source)) continue;
-    for (const entry of source) {
-      if (typeof entry === 'string') {
-        // @ts-expect-error TODO(Phase 2e): type this fully
-        out.push(entry);
-      } else if (entry && typeof entry === 'object') {
-        const id = entry.id ?? entry.sectionId ?? entry.ref?.id;
-        // @ts-expect-error TODO(Phase 2e): type this fully
-        if (id) out.push(String(id));
-      }
-    }
-  }
-  return out;
-}

package/src/concept-parser.ts

@@ -1,235 +0,0 @@
-import * as yaml from 'js-yaml';
-import { Concept } from './models/concept.js';
-import { RelatedConcept } from './models/related-concept.js';
-import { HyperedgeRegistry } from './models/hyperedge-registry.js';
-import { migrateHyperedgeToRelation } from './migration/hyperedge-migrator.js';
-import { InvalidInputError, YamlParseError } from './errors.js';
-
-// Structural keys are reserved at the concept level and excluded
-// from language localization discovery. The set is derived from
-// HyperedgeRegistry — every registered hyperedge class contributes
-// its wireKey and any v1WireKeys to the reserved set. Adding a new
-// hyperedge type means the parser reserves its wire key automatically;
-// no edits here.
-const STRUCTURAL_KEYS = new Set([
-  'termid', 'term', 'figures', 'tables', 'formulas',
-  'related', 'relatedConcepts',
-  'relations',
-  ..._registryStructuralKeys(),
-]);
-
-function _registryStructuralKeys() {
-  const out = [];
-  for (const cls of HyperedgeRegistry.allClasses()) {
-    // @ts-expect-error TODO(Phase 2e): type this fully
-    out.push(cls.wireKey);
-    // @ts-expect-error TODO(Phase 2e): type this fully
-    out.push(_camelCase(cls.wireKey));
-    for (const k of cls.v1WireKeys ?? []) {
-      // @ts-expect-error TODO(Phase 2e): type this fully
-      out.push(k);
-      // @ts-expect-error TODO(Phase 2e): type this fully
-      out.push(_camelCase(k));
-    }
-  }
-  return out;
-}
-
-function _camelCase(s) {
-  if (typeof s !== 'string' || !s.includes('_')) return s;
-  return s.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
-}
-
-export class ConceptParser {
-  parse(raw, context) {
-    const label = context ?? 'concept';
-
-    if (raw == null) {
-      throw new InvalidInputError(
-        `parseConceptYaml requires a non-empty YAML string (${label})`,
-        'non-null string',
-      );
-    }
-    if (typeof raw !== 'string' || raw.trim() === '') {
-      throw new InvalidInputError(
-        `parseConceptYaml requires a non-empty YAML string (${label})`,
-        'non-empty string',
-      );
-    }
-
-    let docs;
-    try {
-      // js-yaml 5.x dropped the explicit DEFAULT_SCHEMA export; the
-      // default schema is applied automatically when no `schema`
-      // option is passed. Passing CORE_SCHEMA reproduces the historical
-      // behavior (yaml.org core schema).
-      docs = yaml.loadAll(raw, { schema: yaml.CORE_SCHEMA ?? yaml.JSON_SCHEMA });
-    } catch (err) {
-      // @ts-expect-error TODO(Phase 2e): type this fully
-      throw new YamlParseError(label, err);
-    }
-
-    return this._detectFormat(docs, label) === 'managed'
-      ? this._parseManaged(docs)
-      : this._parseCanonical(docs[0]);
-  }
-
-  _detectFormat(docs, label) {
-    if (docs.length >= 1 && docs[0]?.data?.identifier !== undefined) return 'managed';
-    if (docs[0] == null) throw new YamlParseError(label, new Error('YAML document is empty'));
-    return 'canonical';
-  }
-
-  _parseCanonical(doc) {
-    const localizations = {};
-    for (const key of Object.keys(doc)) {
-      if (!STRUCTURAL_KEYS.has(key) && typeof doc[key] === 'object' && doc[key] !== null) {
-        localizations[key] = doc[key];
-      }
-    }
-    return new Concept({
-      id: String(doc.termid),
-      term: doc.term || null,
-      localizations,
-      figures: doc.figures,
-      tables: doc.tables,
-      formulas: doc.formulas,
-      relations: _resolveHyperedgeData(doc),
-      raw: doc,
-    });
-  }
-
-  _parseManaged(docs) {
-    const mc = docs[0];
-    const localizations = {};
-
-    for (const doc of docs.slice(1)) {
-      if (!doc?.data?.language_code) continue;
-      const lang = doc.data.language_code;
-      const lcData = { ...doc.data };
-      delete lcData.language_code;
-      localizations[lang] = lcData;
-    }
-
-    // The hyperedge wire keys are reserved at concept level (top-level
-    // of the managed concept YAML), not under data:. Derive the list
-    // from the registry so adding a type doesn't require an edit here.
-    const conceptLevelOnlyKeys = [
-      'related',
-      'relations',
-      ...HyperedgeRegistry.allWireAndLegacyKeys(),
-    ];
-
-    assertConceptLevelOnly(mc, conceptLevelOnlyKeys);
-
-    return new Concept({
-      id: String(mc.data.identifier),
-      term: null,
-      localizations,
-      related: _normalizeRelated(mc.related),
-      relations: _resolveHyperedgeData(mc),
-      domains: mc.data.domains,
-      groups: mc.data.groups,
-      dates: mc.dates ?? mc.data?.dates,
-      sources: mc.sources ?? mc.data?.sources,
-      figures: mc.data?.figures,
-      tables: mc.data?.tables,
-      formulas: mc.data?.formulas,
-      status: mc.status,
-      schemaVersion: mc.schema_version,
-      raw: mc,
-    });
-  }
-}
-
-function assertConceptLevelOnly(mc, keys) {
-  const conceptId = mc?.data?.identifier ?? '<unknown>';
-  for (const key of keys) {
-    const camelKey = _camelCase(key);
-    if (mc?.data?.[key] != null && mc[key] == null && mc[camelKey] == null) {
-      throw new InvalidInputError(
-        `'${key}' must live at concept level (top-level of the managed ` +
-        `concept document), not under data:. Found data.${key} in concept ` +
-        `${conceptId}. Move the key out of the data: block.`,
-        'concept-level ' + key,
-      );
-    }
-  }
-}
-
-// Resolve hyperedge data from any input shape into a single unified
-// array. Iterates HyperedgeRegistry — for each registered class:
-//   - read its wireKey from the container (e.g. partitive_relations)
-//   - read any v1WireKeys (e.g. partitive_hyperedges) and migrate
-//   - tag each entry with the class's typeTag
-//
-// Returns null when no relation data is present, so Concept's
-// `_resolveHyperedges` falls back to the empty-array default.
-//
-// Adding a new hyperedge type means: declare it on a class, register.
-// The parser picks it up automatically — no edits here.
-function _resolveHyperedgeData(container) {
-  if (!container) return null;
-
-  if (Array.isArray(container.relations)) {
-    return container.relations;
-  }
-
-  const out = [];
-
-  for (const cls of HyperedgeRegistry.allClasses()) {
-    // v2 wire key (e.g. partitive_relations)
-    const arr = container[cls.wireKey] ?? container[_camelCase(cls.wireKey)];
-    if (Array.isArray(arr)) {
-      for (const r of arr) {
-        const tagged = _addTypeIfMissing(r, cls.typeTag);
-        // @ts-expect-error TODO(Phase 2e): type this fully
-        if (tagged != null) out.push(tagged);
-      }
-    }
-
-    // v1 legacy wire keys (e.g. partitive_hyperedges) — migrated.
-    // The migration helper produces a v2 hash; we tag it with the
-    // typeTag so Concept's registry dispatch finds the right class.
-    for (const v1Key of cls.v1WireKeys ?? []) {
-      const v1Arr = container[v1Key] ?? container[_camelCase(v1Key)];
-      if (!Array.isArray(v1Arr)) continue;
-      for (const h of v1Arr) {
-        const hash = h?.toJSON && typeof h.toJSON === 'function' ? h.toJSON() : h;
-        const migrated = migrateHyperedgeToRelation(hash);
-        // @ts-expect-error TODO(Phase 2e): type this fully
-        if (migrated) out.push({ ...migrated, type: cls.typeTag });
-      }
-    }
-  }
-
-  return out.length > 0 ? out : null;
-}
-
-function _addTypeIfMissing(value, type) {
-  if (value == null) return null;
-  if (typeof value.toJSON === 'function') {
-    const hash = value.toJSON();
-    return hash.type ? hash : { ...hash, type };
-  }
-  if (typeof value === 'object') {
-    return value.type ? value : { ...value, type };
-  }
-  return value;
-}
-
-function _normalizeRelated(arr) {
-  if (!arr || !Array.isArray(arr)) return [];
-  return arr.map(r => {
-    if (r instanceof RelatedConcept) return r;
-    if (r.ref != null && typeof r.ref !== 'object') {
-      throw new InvalidInputError(
-        `RelatedConcept.ref must be an object { source, id }, got: ${typeof r.ref}`,
-        'object',
-      );
-    }
-    return new RelatedConcept(r);
-  });
-}
-
-export const conceptParser = new ConceptParser();