(validate child '("itemIdentity" "scope" "resourceData" "resourceRef"))))
(unless scope-seen (reject :missing-variant-scope "variant requires a scope element." node))
(unless resource-seen (reject :missing-variant-resource "variant requires a resource element." node))))
+ ((string= name "occurrence")
+ (attributes node '("reifier") nil)
+ (when (attr node "reifier")
+ (resolve-iri (attr node "reifier") *document-iri* node))
+ (let ((phase 0) (type-seen nil) (scope-seen nil) (resource-seen nil))
+ (dolist (child (elements node))
+ (check-namespace child)
+ (let* ((kind (node-name child))
+ (next (cond ((string= kind "itemIdentity") 0)
+ ((string= kind "type") 1)
+ ((string= kind "scope") 2)
+ ((member kind '("resourceData" "resourceRef") :test #'string=) 3))))
+ (unless next (reject :unexpected-element (format nil "Unexpected ~A element." kind) child))
+ (when (< next phase) (reject :element-order "occurrence child order is invalid." child))
+ (setf phase next)
+ (cond
+ ((string= kind "itemIdentity") nil)
+ ((string= kind "type")
+ (when type-seen (reject :duplicate-occurrence-type "Only one occurrence type is allowed." child))
+ (setf type-seen t))
+ ((string= kind "scope")
+ (unless type-seen (reject :missing-occurrence-type "occurrence requires type before scope." child))
+ (when scope-seen (reject :duplicate-occurrence-scope "Only one occurrence scope is allowed." child))
+ (setf scope-seen t))
+ (t
+ (unless type-seen (reject :missing-occurrence-type "occurrence requires type before its resource." child))
+ (when resource-seen (reject :occurrence-resource-cardinality "occurrence requires exactly one resource." child))
+ (setf resource-seen t)))
+ (validate child '("itemIdentity" "type" "scope" "resourceData" "resourceRef"))))
+ (unless type-seen (reject :missing-occurrence-type "occurrence requires a type element." node))
+ (unless resource-seen (reject :missing-occurrence-resource "occurrence requires a resource element." node))))
+ ((member name '("association" "role") :test #'string=)
+ (attributes node '("reifier") nil)
+ (when (attr node "reifier")
+ (resolve-iri (attr node "reifier") *document-iri* node))
+ (let ((association-p (string= name "association"))
+ (phase 0) (type-seen nil) (scope-seen nil) (participants 0))
+ (dolist (child (elements node))
+ (check-namespace child)
+ (let* ((kind (node-name child))
+ (next (cond ((string= kind "itemIdentity") 0)
+ ((string= kind "type") 1)
+ ((and association-p (string= kind "scope")) 2)
+ ((string= kind (if association-p "role" "topicRef")) 3))))
+ (unless next (reject :unexpected-element (format nil "Unexpected ~A element." kind) child))
+ (when (< next phase) (reject :element-order (format nil "~A child order is invalid." name) child))
+ (setf phase next)
+ (cond
+ ((string= kind "itemIdentity") nil)
+ ((string= kind "type")
+ (when type-seen (reject :duplicate-type (format nil "Only one ~A type is allowed." name) child))
+ (setf type-seen t))
+ (t
+ (unless type-seen
+ (reject :missing-type (format nil "~A requires type before ~A." name kind) child))
+ (if (string= kind "scope")
+ (progn
+ (when scope-seen (reject :duplicate-scope "Only one association scope is allowed." child))
+ (setf scope-seen t))
+ (progn
+ (incf participants)
+ (when (and (not association-p) (> participants 1))
+ (reject :role-player-cardinality "role requires exactly one topicRef player." child))))))
+ (validate child (if association-p '("itemIdentity" "type" "scope" "role") '("itemIdentity" "type" "topicRef")))))
+ (unless type-seen (reject :missing-type (format nil "~A requires a type element." name) node))
+ (when (zerop participants)
+ (reject (if association-p :missing-roles :missing-role-player)
+ (if association-p "association requires at least one role." "role requires a topicRef player.") node))))
((string= name "resourceRef") (leaf-href node))
((string= name "resourceData")
(attributes node '("datatype") nil)
(topic-maps.tmdm:make-association map (core-topic map "type-instance")
(list (list (core-topic map "type") type)
(list (core-topic map "instance") (topic-maps.tmdm:canonical-topic owner)))))))
+(defun read-item-identities (node item)
+ ;; XTM 4.6: assign locators to the actual canonical item, never intern Topics.
+ ;; ADD-ITEM-IDENTIFIER owns set semantics and cross-item conflict checks.
+ (dolist (child (elements node) item)
+ (when (string= (node-name child) "itemIdentity")
+ (setf item (topic-maps.tmdm:add-item-identifier item (leaf-href child))))))
+(defun read-association (node map)
+ ;; Resolve references in source order, then construct the complete native
+ ;; Association. The constructor may already merge Associations AND Roles.
+ (let ((type nil) (scope nil) (roles nil) (role-nodes nil))
+ (labels ((reference (ref) (find-reference-topic map (reference-iri ref)))
+ (type-reference (node) (reference (first (elements node)))))
+ (dolist (child (elements node))
+ (cond ((string= (node-name child) "type") (setf type (type-reference child)))
+ ((string= (node-name child) "scope") (setf scope (mapcar #'reference (elements child))))
+ ((string= (node-name child) "role")
+ (let ((children (elements child)))
+ (push (list (type-reference (find "type" children :key #'node-name :test #'string=))
+ (reference (find "topicRef" children :key #'node-name :test #'string=))) roles)
+ (push child role-nodes)))))
+ (let ((association (read-item-identities node
+ (topic-maps.tmdm:make-association map type (reverse roles) :scope scope))))
+ ;; Match source metadata to the native Role by its complete signature
+ ;; within THIS canonical Parent. Role order/II are not equality keys.
+ (loop for pair in (reverse roles) for source in (reverse role-nodes) do
+ ;; A preceding Role Reifier may have merged Topics and this Parent.
+ (setf association (topic-maps.tmdm:canonical-association association))
+ (let ((role (find-if (lambda (role)
+ (and (eq (topic-maps.tmdm:association-role-type role)
+ (topic-maps.tmdm:canonical-topic (first pair)))
+ (eq (topic-maps.tmdm:association-role-player role)
+ (topic-maps.tmdm:canonical-topic (second pair)))))
+ (topic-maps.tmdm:association-roles association))))
+ (setf role (read-item-identities source role))
+ (read-item-reifier source (topic-maps.tmdm:canonical-association-role role) map)))
+ ;; Role metadata is now on the native canonical Parent. Reifier merging
+ ;; may normalize it again; return the resulting Association handle.
+ (topic-maps.tmdm:canonical-association
+ (read-item-reifier node association map))))))
(defun read-resource-value (resource)
"Return value and datatype for a validated resource node (XTM 4.16/4.17).
This operation neither looks up Topics nor fetches resources. ANYTYPE is rejected
;; ADD-VARIANT owns canonicalization and the proper-superset constraint.
(let ((variant (topic-maps.tmdm:add-variant name value :datatype datatype
:scope (append (topic-maps.tmdm:topic-name-scope name) explicit))))
- (dolist (child children)
- (when (string= (node-name child) "itemIdentity")
- (setf variant (topic-maps.tmdm:add-item-identifier variant (leaf-href child)))))
+ (setf variant (read-item-identities node variant))
;; Reification may normalize again; retain the native canonical handle.
(topic-maps.tmdm:canonical-variant (read-item-reifier node variant map))))))
(defun read-name (node owner map)
(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)
- (when (string= (node-name child) "itemIdentity")
- (setf name (topic-maps.tmdm:add-item-identifier name (leaf-href child)))))
+ (setf name (read-item-identities node name))
;; ADD-NAME may have returned an existing canonical Name. Reifier
;; resolution/merging can normalize it again: retain the native result
;; before processing Variants and return the current Name handle.
(dolist (child children)
(when (string= (node-name child) "variant") (read-variant child name map)))
(topic-maps.tmdm:canonical-topic-name name))))
+(defun read-occurrence (node owner map)
+ ;; XTM 4.13-4.17/4.20: reuse native Topics and the qualified resource path.
+ ;; ADD-OCCURRENCE owns live Parent/Type/Scope handles and TMDM 5.6/6.5 merging.
+ (let* ((children (elements node))
+ (type-node (find "type" children :key #'node-name :test #'string=))
+ (type (find-reference-topic map (reference-iri (first (elements type-node)))))
+ (scope-node (find "scope" children :key #'node-name :test #'string=))
+ (scope (when scope-node (mapcar (lambda (ref) (find-reference-topic map (reference-iri ref)))
+ (elements scope-node))))
+ (resource (find-if (lambda (child) (member (node-name child) '("resourceData" "resourceRef") :test #'string=)) children)))
+ (multiple-value-bind (value datatype) (read-resource-value resource)
+ (topic-maps.tmdm:canonical-occurrence
+ ;; Resolve Reifier by II only after native Occurrence normalization and
+ ;; II assignment. Reifier merging can normalize again: return its handle.
+ (read-item-reifier node
+ (read-item-identities node
+ (topic-maps.tmdm:add-occurrence owner type value :datatype datatype :scope scope)) map)))))
(defun read-topic (node map)
(let ((topic (topic-maps.tmdm:intern-topic map :item-identifier
(concatenate 'string *document-iri* "#" (collapse-space (attr node "id"))))))
(cond
((string= name "instanceOf") (read-instance-of child topic map))
((string= name "name") (read-name child topic map))
+ ((string= name "occurrence") (read-occurrence child topic map))
(t (setf topic (topic-maps.tmdm:add-topic-identifier topic
(cond ((string= name "itemIdentity") :item-identifier)
((string= name "subjectIdentifier") :subject-identifier)
((string= (node-name child) "mergeMap")
(read-mergemap child map resource-resolver max-resource-depth
(cons document-iri active-iris)))
+ ((string= (node-name child) "association") (read-association child map))
(t (read-topic child map))))
map)))