glossarist 0.4.26 → 0.4.28

package/package.json

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

package/src/diff/diff-renderer.js

@@ -1,4 +1,5 @@
 import { TextDiff } from './text-diff.js';
+import { resolveMultiplicity } from '../models/multiplicity.js';
 
 const COLORS = {
   red: s => `\x1b[31m${s}\x1b[0m`,
@@ -206,7 +207,7 @@ function relationLabel(r) {
     ? r.partitives.map(m => {
         const ref = m?.ref ?? m ?? {};
         let tail = '';
-        const mult = m?.multiplicity;
+        const mult = resolveMultiplicity(m);
         if (mult && mult !== 'compulsory') tail = ` (${mult})`;
         if (m?.is_delimiting === true) tail += ' ⊘';
         return `${ref.id ?? ref.source ?? ref.text ?? '?'}${tail}`;
@@ -236,7 +237,7 @@ export function multiplicityStats(relations) {
   for (const rel of relations ?? []) {
     for (const m of rel?.partitives ?? []) {
       total += 1;
-      const mult = m?.multiplicity ?? 'compulsory';
+      const mult = resolveMultiplicity(m);
       byMultiplicity[mult] = (byMultiplicity[mult] ?? 0) + 1;
       const p = m?.presence ?? 'required';
       const c = m?.count ?? 'exactly_one';

package/src/migration/partitive-relation-migrator.js

@@ -8,7 +8,7 @@
 // ISO 704:2022 correction):
 //
 //   comprehensive      → comprehensive     (unchanged shape)
-//   parts: [ref, ...]  → partitives: [{ ref, multiplicity: 'compulsory' }, ...]
+//   parts: [ref, ...]  → partitives: [{ ref, presence: 'required', count: 'exactly_one' }, ...]
 //   enumeration: open  → completeness: partial
 //   enumeration: closed→ completeness: complete
 //   markers: [...]     → (dropped — v2 uses per-member multiplicity

package/src/models/index.js

@@ -63,6 +63,7 @@ export {
   isValidMultiplicity,
   multiplicityFromPair,
   pairFromMultiplicity,
+  resolveMultiplicity,
 } from './multiplicity.js';
 
 // v1 → v2 migration helper. Pure function; idempotent.

package/src/models/multiplicity.js

@@ -66,6 +66,32 @@ export function isValidMultiplicity(name) {
   return Object.prototype.hasOwnProperty.call(PAIR_BY_NAME, name);
 }
 
+/**
+ * Resolve the ISO 704 multiplicity name from any object carrying
+ * `presence` + `count`, OR a legacy object that still has a literal
+ * `multiplicity` field (pre-v4 JSON).
+ *
+ * For v4 `PartitiveMember` instances, `presence` + `count` are always
+ * set (defaults applied at construction), so the legacy branch never
+ * fires on a real instance — it exists purely to round-trip raw JSON
+ * that bypassed the model constructor.
+ *
+ * Throws on the invalid `(optional, at_least_one)` combination — the
+ * model already rejects this at construction, so reaching the throw
+ * here means the caller bypassed the model. Let the error propagate
+ * rather than silently returning 'compulsory' (which would mask the
+ * data corruption).
+ */
+export function resolveMultiplicity(member) {
+  if (member?.presence && member?.count) {
+    return multiplicityFromPair(member.presence, member.count);
+  }
+  if (typeof member?.multiplicity === 'string') {
+    return member.multiplicity;
+  }
+  return DEFAULT_MULTIPLICITY;
+}
+
 function invalidCombinationError(presence, count) {
   return new Error(
     `Invalid multiplicity combination: presence=${presence}, count=${count}. ` +

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

@@ -21,6 +21,7 @@
 
 import { PRED } from './predicates.js';
 import { namedNode, literal, quad } from './terms.js';
+import { resolveMultiplicity } from '../models/multiplicity.js';
 
 // SKOS taxonomy namespaces (concept-model will ship these taxonomies).
 // Until then, the URIs are forward-compatible and resolve once the
@@ -45,11 +46,15 @@ export function* partitiveMemberToQuads(member, { memberUri }) {
     );
   }
   // Derived multiplicity URI for v3 RDF consumer backward compat.
-  // multiplicity is computed from (presence, count) via the model's
-  // accessor; fall back to the raw field for raw JSON input.
-  const mult = typeof member?.multiplicity === 'string'
-    ? member.multiplicity
-    : null;
+  // v4 PartitiveMember carries presence + count natively; the legacy
+  // multiplicity name is derived via the SSOT resolveMultiplicity().
+  // For raw pre-v4 JSON that bypassed the model constructor and still
+  // carries a literal multiplicity field, the resolver falls back to
+  // that field. The invalid (optional, at_least_one) combination is
+  // rejected at model construction — if it reaches the throw here,
+  // the caller bypassed the model and we want the error to surface
+  // rather than silently producing wrong RDF.
+  const mult = resolveMultiplicity(member);
   if (mult) {
     yield quad(
       namedNode(memberUri),