(defun unsupported (node)
(reject :unsupported-construct (format nil "XTM ~A is not implemented in this subset." (node-name node))
node 'xtm-unsupported))
-(defun check-reifier (node)
- (when (attr node "reifier")
- (reject :reification "XTM Reification is outside this subset." node 'xtm-unsupported)))
(defun leaf-href (node)
(attributes node '("href") '("href"))
(when (elements node) (reject :unexpected-child "A locator element must be empty." node))
(attributes node '("version" "reifier") '("version"))
(unless (equal (attr node "version") "2.0")
(reject :invalid-version "This reader accepts XTM version 2.0 only." node))
- (check-reifier node)
+ (when (attr node "reifier")
+ (resolve-iri (attr node "reifier") *document-iri* node))
(let ((phase 0))
(dolist (child (elements node))
(let* ((name (node-name child))
(dolist (child (elements node)) (validate child '("topicRef"))))
((string= name "name")
(attributes node '("reifier") nil)
- (check-reifier node)
+ (when (attr node "reifier")
+ (resolve-iri (attr node "reifier") *document-iri* node))
(let ((phase 0) (type-seen nil) (scope-seen nil) (value-seen nil))
(dolist (child (elements node))
(check-namespace child)
(reject :element-order "name child order is invalid." child))
(setf phase next)
(cond
- ((string= kind "itemIdentity") nil)
+ ((member kind '("itemIdentity" "variant") :test #'string=) nil)
((string= kind "type")
(when type-seen (reject :duplicate-name-type "Only one name type is allowed." child))
(setf type-seen t))
;; Valid extension points remain explicitly unsupported.
;; Their complete subgrammars are outside this subset.
(t (unsupported child)))
- (validate child '("itemIdentity" "type" "scope" "value"))))
+ (validate child '("itemIdentity" "type" "scope" "value" "variant"))))
(unless value-seen (reject :missing-name-value "name requires a value element." node))))
+ ((string= name "variant")
+ (attributes node '("reifier") nil)
+ (when (attr node "reifier") (resolve-iri (attr node "reifier") *document-iri* node))
+ (let ((phase 0) (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 "scope") 1)
+ ((member kind '("resourceData" "resourceRef") :test #'string=) 2))))
+ (unless next (reject :unexpected-element (format nil "Unexpected ~A element." kind) child))
+ (when (< next phase) (reject :element-order "variant child order is invalid." child))
+ (setf phase next)
+ (cond
+ ((string= kind "itemIdentity") nil)
+ ((string= kind "scope")
+ (when scope-seen (reject :duplicate-variant-scope "Only one variant scope is allowed." child))
+ (setf scope-seen t))
+ (t
+ (unless scope-seen (reject :missing-variant-scope "variant requires scope before its resource." child))
+ (when resource-seen (reject :variant-resource-cardinality "variant requires exactly one resource." child))
+ (setf resource-seen t)))
+ (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 "resourceRef") (leaf-href node))
+ ((string= name "resourceData")
+ (attributes node '("datatype") nil)
+ (let ((datatype (attr node "datatype")))
+ ;; DATATYPE is already an absolute IRI, not content to
+ ;; resolve against the document or percent-normalize.
+ (when datatype
+ (unless (iri-parts-scheme (split-iri datatype))
+ (reject :invalid-resource-data-datatype "resourceData datatype must be an absolute IRI." node))
+ (validate-decoded-reference (unescape-reference datatype node) node)
+ (unless (member datatype (list (topic-maps.tmdm:string-datatype) (topic-maps.tmdm:iri-datatype)) :test #'equal)
+ (reject :resource-data-datatype "Only textual xsd:string and xsd:anyURI resourceData are implemented." node 'xtm-unsupported)))
+ (dolist (child (node-children node))
+ (unless (stringp child)
+ (if (or (equal datatype (topic-maps.tmdm:iri-datatype)) (equal (node-uri child) +namespace+))
+ (reject :unexpected-child
+ (if (equal datatype (topic-maps.tmdm:iri-datatype))
+ "anyURI resourceData cannot contain child elements."
+ "resourceData cannot contain XTM markup.") child)
+ (reject :resource-data-markup "Embedded XML resourceData is outside this subset." child 'xtm-unsupported))))))
((string= name "type")
(attributes node nil nil)
(let ((refs (elements node)))
(topic-maps.tmdm:topic-map-topics map))))
(if topic (topic-maps.tmdm:canonical-topic topic)
(topic-maps.tmdm:intern-topic map :item-identifier iri))))
+(defun read-item-reifier (node item map)
+ ;; XTM 4.3.2 looks up Item Identifiers only, unlike topicRef (4.20).
+ ;; INTERN-TOPIC adds the II on a miss; any SI/II identity merging then
+ ;; follows the existing TMDM rules, independently of this lookup.
+ (when (attr node "reifier")
+ (let* ((iri (resolve-iri (attr node "reifier") *document-iri* node))
+ (topic (or (find iri (topic-maps.tmdm:topic-map-topics map)
+ :test (lambda (iri topic)
+ (member iri (topic-maps.tmdm:topic-item-identifiers topic) :test #'string=)))
+ (topic-maps.tmdm:intern-topic map :item-identifier iri))))
+ (return-from read-item-reifier (topic-maps.tmdm:set-item-reifier item topic))))
+ item)
+(defun read-map-reifier (node map)
+ (read-item-reifier node map map))
(defun core-topic (map local)
(topic-maps.tmdm:intern-topic map :subject-identifier
(concatenate 'string "http://psi.topicmaps.org/iso13250/model/" local)))
(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-variant (node name map)
+ (let* ((children (elements node))
+ (scope-node (find "scope" children :key #'node-name :test #'string=))
+ (resource (find-if (lambda (child) (member (node-name child) '("resourceData" "resourceRef") :test #'string=)) children))
+ (reference-p (string= (node-name resource) "resourceRef"))
+ (uri-data-p (and (not reference-p) (equal (attr resource "datatype") (topic-maps.tmdm:iri-datatype))))
+ (explicit (mapcar (lambda (ref) (find-reference-topic map (reference-iri ref))) (elements scope-node)))
+ ;; A resource locator is a value, not a topic reference. LEAF-HREF uses
+ ;; the shared XTM IRI resolver without topic lookup or resource access.
+ (text (unless reference-p (with-output-to-string (out)
+ (dolist (part (node-children resource)) (write-string part out)))))
+ (value (cond (reference-p (leaf-href resource))
+ (uri-data-p (resolve-iri text *document-iri* resource))
+ (t text))))
+ ;; ADD-VARIANT canonicalizes the union and enforces the proper superset.
+ ;; A nonempty explicit scope may still add no theme to the Name scope.
+ (let ((variant (topic-maps.tmdm:add-variant name value
+ :datatype (if (or reference-p uri-data-p) (topic-maps.tmdm:iri-datatype) (topic-maps.tmdm:string-datatype))
+ :scope (append (topic-maps.tmdm:topic-name-scope name) explicit))))
+ ;; Normalize first: an equal Variant may already own this identifier.
+ ;; Keep the native canonical result and its global conflict conditions.
+ (dolist (child children)
+ (when (string= (node-name child) "itemIdentity")
+ (setf variant (topic-maps.tmdm:add-item-identifier variant (leaf-href child)))))
+ ;; Reification may merge Topics and normalize this Variant again.
+ ;; Reuse the II-only resolver and retain its current native result.
+ (topic-maps.tmdm:canonical-variant (read-item-reifier node variant map)))))
(defun read-name (node owner map)
(let* ((children (elements node))
(type-node (find "type" children :key #'node-name :test #'string=))
(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)
+ (dolist (child children)
(when (string= (node-name child) "itemIdentity")
- (setf name (topic-maps.tmdm:add-item-identifier name (leaf-href child))))))))
+ (setf name (topic-maps.tmdm:add-item-identifier name (leaf-href child)))))
+ ;; 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.
+ (setf name (read-item-reifier node name map))
+ (dolist (child children)
+ (when (string= (node-name child) "variant") (read-variant child name map)))
+ (topic-maps.tmdm:canonical-topic-name name))))
(defun read-topic (node map)
(let ((topic (topic-maps.tmdm:intern-topic map :item-identifier
(concatenate 'string *document-iri* "#" (collapse-space (attr node "id"))))))
:line (sax:line-number handler) :column (sax:column-number handler)))))
(map (topic-maps.tmdm:make-topic-map)))
(validate-source root)
+ ;; The attribute is processed before itemIdentity and later Topic nodes.
+ (read-map-reifier root map)
(dolist (child (elements root))
(if (string= (node-name child) "itemIdentity")
(topic-maps.tmdm:add-item-identifier map (leaf-href child))