]> dreyeck.freedombox.rocks Git - topic-maps.git/blobdiff - src/tmdm/items.lisp
feat(tmdm): merge same-map topic identities and retarget name references
[topic-maps.git] / src / tmdm / items.lisp
index 65fc13a58b9f2465e14df7624d61289a6b5562e1..b3d90f84724985eb2281995d16e0fa4033ad0a53 100644 (file)
@@ -1,15 +1,42 @@
 (in-package #:topic-maps.tmdm)
 
-;;; Only the information-item properties used by Slice 1 are materialized.
+;;; Only Topic Map, Topic and unscoped Name properties are materialized.
 ;;; Omitted set-valued properties are implicitly empty, single-valued ones null
 ;;; (CTM 3.2). In particular all supported names have empty scope and variants.
-(defstruct topic-map topics)
-(defstruct (topic (:constructor %make-topic (parent)))
-  (parent nil :read-only t) item-identifiers subject-identifiers subject-locators names)
-(defstruct (topic-name (:constructor %make-topic-name (value type parent)))
+(defstruct (topic-map (:constructor make-topic-map ()) (:conc-name %topic-map-)) topics)
+(defstruct (topic (:constructor %make-topic (parent)) (:conc-name %topic-))
+  (parent nil :read-only t) item-identifiers subject-identifiers subject-locators names
+  ;; Implementation bookkeeping, not a TMDM property or another information item.
+  forward)
+(defstruct (topic-name (:constructor %make-topic-name (value type parent)) (:conc-name %topic-name-))
   (value "" :type string :read-only t)
-  (type nil :type topic :read-only t)
-  (parent nil :type topic :read-only t))
+  (type nil :type topic)
+  (parent nil :type topic)
+  forward)
+
+(defun canonical-topic (topic)
+  "Resolve a retained reference to a Topic replaced by same-map merging.
+EQ on obsolete objects does not change; compare their canonical representatives."
+  (check-type topic topic)
+  (loop for current = topic then (%topic-forward current)
+        unless (%topic-forward current) return current))
+(defun canonical-topic-name (name)
+  "Resolve a retained reference to a Name replaced during duplicate removal."
+  (check-type name topic-name)
+  (loop for current = name then (%topic-name-forward current)
+        unless (%topic-name-forward current) return current))
+
+;; Public readers resolve obsolete handles and expose copies of set storage.
+;; Mutations must use the identity/merge API to maintain model invariants.
+(defun topic-map-topics (map) (copy-list (%topic-map-topics map)))
+(defun topic-parent (topic) (%topic-parent (canonical-topic topic)))
+(defun topic-item-identifiers (topic) (copy-list (%topic-item-identifiers (canonical-topic topic))))
+(defun topic-subject-identifiers (topic) (copy-list (%topic-subject-identifiers (canonical-topic topic))))
+(defun topic-subject-locators (topic) (copy-list (%topic-subject-locators (canonical-topic topic))))
+(defun topic-names (topic) (copy-list (%topic-names (canonical-topic topic))))
+(defun topic-name-value (name) (%topic-name-value (canonical-topic-name name)))
+(defun topic-name-type (name) (%topic-name-type (canonical-topic-name name)))
+(defun topic-name-parent (name) (%topic-name-parent (canonical-topic-name name)))
 
 ;; Avoid recursive printing through parent/type links; DESCRIBE remains useful.
 (defmethod print-object ((item topic-map) stream)
   (print-unreadable-object (item stream :type t :identity t)
     (format stream "~S" (topic-name-value item))))
 
-(defun identifiers (topic kind)
-  (ecase kind
-    (:item-identifier (topic-item-identifiers topic))
-    (:subject-identifier (topic-subject-identifiers topic))
-    (:subject-locator (topic-subject-locators topic))))
-
-(defun intern-topic (map kind iri)
-  "Within one map, reuse an equal identity reference (TMDM 5.3.5).
-This restricted interning does not implement general merge or cross-map merge."
-  (unless (and (typep map 'topic-map) (stringp iri) (plusp (length iri)))
-    (error "A map and a nonempty locator string are required."))
-  (let* ((kinds (ecase kind
-                  ((:item-identifier :subject-identifier)
-                   '(:item-identifier :subject-identifier))
-                  (:subject-locator '(:subject-locator))))
-         (existing
-           (find-if (lambda (topic)
-                      (some (lambda (property)
-                              (member iri (identifiers topic property) :test #'string=))
-                            kinds))
-                    (topic-map-topics map)))
-         (topic (or existing (%make-topic map))))
-    (unless existing
-      ;; Private storage mutation: list order is observational, not TMDM semantics.
-      (setf (topic-map-topics map) (append (topic-map-topics map) (list topic))))
-    (ecase kind
-      (:item-identifier (pushnew iri (topic-item-identifiers topic) :test #'string=))
-      (:subject-identifier (pushnew iri (topic-subject-identifiers topic) :test #'string=))
-      (:subject-locator (pushnew iri (topic-subject-locators topic) :test #'string=)))
-    topic))
-
 (defun default-name-type-identifier ()
   "http://psi.topicmaps.org/iso13250/model/topic-name")
-
-(defun add-default-name (topic value)
-  "CTM 3.11 default type; unscoped name equality per TMDM 5.4."
-  (check-type topic topic)
-  (check-type value string)
-  (let* ((type (intern-topic (topic-parent topic) :subject-identifier
-                            (default-name-type-identifier)))
-         (existing (find-if (lambda (name)
-                              (and (string= value (topic-name-value name))
-                                   (eq type (topic-name-type name))))
-                            (topic-names topic))))
-    (or existing
-        (let ((name (%make-topic-name value type topic)))
-          (setf (topic-names topic) (append (topic-names topic) (list name)))
-          name))))