]> dreyeck.freedombox.rocks Git - topic-maps.git/blobdiff - src/xtm/reader.lisp
Support XTM topic name item identifiers with original contracts and offline evidence
[topic-maps.git] / src / xtm / reader.lisp
index eebf157784e6004d66e958195791bc115327e402..17cabb2fa672efca0bb97e259b3884afebab093e 100644 (file)
@@ -124,7 +124,7 @@ constructs' complete subgrammars is made. XML errors have already been checked."
                    ((string= name "name")
                     (attributes node '("reifier") nil)
                     (check-reifier node)
-                    (let ((phase 0) (type-seen nil) (value-seen nil))
+                    (let ((phase 0) (type-seen nil) (scope-seen nil) (value-seen nil))
                       (dolist (child (elements node))
                         (check-namespace child)
                         (let* ((kind (node-name child))
@@ -134,22 +134,30 @@ constructs' complete subgrammars is made. XML errors have already been checked."
                             (reject :element-order "name child order is invalid." child))
                           (setf phase next)
                           (cond
+                            ((string= kind "itemIdentity") nil)
                             ((string= kind "type")
                              (when type-seen (reject :duplicate-name-type "Only one name type is allowed." child))
                              (setf type-seen t))
+                            ((string= kind "scope")
+                             (when scope-seen (reject :duplicate-name-scope "Only one name scope is allowed." child))
+                             (setf scope-seen t))
                             ((string= kind "value")
                              (when value-seen (reject :duplicate-name-value "Only one name value is allowed." child))
                              (setf value-seen t))
                             ;; Valid extension points remain explicitly unsupported.
                             ;; Their complete subgrammars are outside this subset.
                             (t (unsupported child)))
-                          (validate child '("type" "value"))))
+                          (validate child '("itemIdentity" "type" "scope" "value"))))
                       (unless value-seen (reject :missing-name-value "name requires a value element." node))))
                    ((string= name "type")
                     (attributes node nil nil)
                     (let ((refs (elements node)))
                       (unless (= 1 (length refs)) (reject :type-cardinality "type requires exactly one topicRef." node))
                       (validate (first refs) '("topicRef"))))
+                   ((string= name "scope")
+                    (attributes node nil nil)
+                    (unless (elements node) (reject :empty-scope "scope requires at least one topicRef." node))
+                    (dolist (child (elements node)) (validate child '("topicRef"))))
                    ((string= name "value")
                     (attributes node nil nil)
                     ;; VALUE accepts all character data, including empty text and
@@ -184,15 +192,24 @@ constructs' complete subgrammars is made. XML errors have already been checked."
 (defun read-name (node owner map)
   (let* ((children (elements node))
          (type-node (find "type" children :key #'node-name :test #'string=))
+         (scope-node (find "scope" children :key #'node-name :test #'string=))
+         (type (when type-node (find-reference-topic map (reference-iri (first (elements type-node))))))
+         (scope (when scope-node (mapcar (lambda (ref) (find-reference-topic map (reference-iri ref)))
+                                        (elements scope-node))))
          (value-node (find "value" children :key #'node-name :test #'string=))
          (value (with-output-to-string (out)
                   (dolist (part (node-children value-node)) (write-string part out)))))
     ;; SAX has already resolved XML character/entity references. Preserve the
     ;; resulting Unicode sequence without trimming or decoding it again.
-    (if type-node
-        (topic-maps.tmdm:add-name owner value
-          :type (find-reference-topic map (reference-iri (first (elements type-node)))))
-        (topic-maps.tmdm:add-default-name owner value))))
+    ;; ADD-NAME owns canonical set semantics and normalization after merging.
+    (let ((name (if type-node
+                    (topic-maps.tmdm:add-name owner value :type type :scope scope)
+                    (topic-maps.tmdm:add-default-name owner value :scope scope))))
+      ;; Item identifiers belong to the canonical Name, never its owner/type.
+      ;; Use the shared model API for set semantics and global conflicts.
+      (dolist (child children name)
+        (when (string= (node-name child) "itemIdentity")
+          (setf name (topic-maps.tmdm:add-item-identifier name (leaf-href child))))))))
 (defun read-topic (node map)
   (let ((topic (topic-maps.tmdm:intern-topic map :item-identifier
                  (concatenate 'string *document-iri* "#" (collapse-space (attr node "id"))))))