(when (< next phase) (reject :element-order "topicMap child order is invalid." child))
(setf phase next)
(validate child '("itemIdentity" "mergeMap" "topic" "association"))))))
+ ((string= name "mergeMap") (mergemap-iri node))
((string= name "topic")
(attributes node '("id") '("id"))
(let ((id (collapse-space (attr node "id"))))
(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)
+ (reject :unsupported-construct "XTM occurrence reification is not implemented in this subset." node 'xtm-unsupported))
+ (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")
+ (validate child '("itemIdentity"))
+ (reject :unsupported-construct "XTM occurrence item identifiers are not implemented in this subset." child 'xtm-unsupported))
+ ((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 '("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))))
((string= name "resourceRef") (leaf-href node))
((string= name "resourceData")
(attributes node '("datatype") nil)
(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
+ (topic-maps.tmdm:add-occurrence owner type value :datatype datatype :scope scope)))))
(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)
(t :subject-locator))
(leaf-href child)))))))
(topic-maps.tmdm:canonical-topic topic)))
-(defun deserialize-octets (bytes &key document-iri source-key)
- "Deserialize raw XML octets into a new TMDM Topic Map (XTM 2.0 identity/Name subset).
-DOCUMENT-IRI is required, absolute and fragment-free. SOURCE-KEY is a diagnostic
-label only. XML positions are approximate SAX line/column values, not spans.
-XML-policy errors, XTM rejection/unsupported and original TMDM conflicts remain
-distinct. No resources are fetched. No externally supplied Map is mutated."
+(defun mergemap-iri (node)
+ (let ((iri (leaf-href node)))
+ (when (iri-parts-fragment (split-iri iri))
+ (reject :mergemap-fragment "mergeMap href must not have a fragment identifier." node))
+ iri))
+(defun resource-failure (code detail node &optional cause)
+ (error 'xtm-resource-error :code code :detail detail :cause cause
+ :document-iri *document-iri* :source-key *source-key*
+ :line (node-line node) :column (node-column node)))
+(defun resource-octets-p (value)
+ ;; Same resolver value convention as CTM, without a dependency on its Reader.
+ (and (vectorp value) (not (stringp value))
+ (every (lambda (n) (and (integerp n) (<= 0 n 255))) value)))
+(defun read-mergemap (node map resolver max-depth active-iris)
+ (let ((resource (mergemap-iri node)))
+ (unless resolver
+ (reject :resource-resolver-required "mergeMap requires an explicit resource resolver; no resource was loaded." node 'xtm-unsupported))
+ ;; These are finite resource-policy guards, not normative cycle semantics.
+ ;; Each independent public call starts a new active path; siblings may repeat.
+ (when (member resource active-iris :test #'string=)
+ (reject :cyclic-mergemap "Active recursive XTM resource dependency; cycle processing is not implemented." node 'xtm-unsupported))
+ (when (>= (length active-iris) (1+ max-depth))
+ (reject :resource-depth-limit "Configured nested XTM resource limit reached; this is implementation policy." node 'xtm-unsupported))
+ (multiple-value-bind (bytes source-key)
+ (handler-case
+ (funcall resolver resource :purpose :mergemap :from-document-iri *document-iri*
+ :notation "http://psi.topicmaps.org/iso13250/xtm")
+ (error (c) (resource-failure :resource-resolver-failure (princ-to-string c) node c)))
+ (unless bytes
+ (resource-failure :resource-unavailable "Resolver declined or did not supply the requested XTM resource." node))
+ (unless (and (resource-octets-p bytes) (or (null source-key) (stringp source-key)))
+ (resource-failure :invalid-resource-result "Resolver must return an octet vector and a string source key or NIL." node))
+ (let ((source (deserialize-document
+ (if (typep bytes '(vector (unsigned-byte 8))) bytes
+ (map '(vector (unsigned-byte 8)) #'identity bytes))
+ resource (or source-key resource) resolver max-depth active-iris)))
+ ;; Import only Topics/Associations. The existing operation preflights
+ ;; conflicts, preserves SOURCE, and excludes its Map identifiers/reifier.
+ (handler-case (topic-maps.tmdm:import-map-content map source)
+ (error (c) (resource-failure :mergemap-import-failure (princ-to-string c) node c)))))))
+(defun deserialize-octets (bytes &key document-iri source-key resource-resolver (max-resource-depth 32))
+ "Deserialize raw XTM 2.0 octets into a fresh TMDM Map.
+DOCUMENT-IRI is required, absolute and fragment-free. SOURCE-KEY is diagnostic.
+RESOURCE-RESOLVER is optional: (resolver absolute-iri :purpose :mergemap
+ :from-document-iri parent-iri :notation XTM-notation-IRI)
+returns raw octets and an optional diagnostic source key. No implicit I/O.
+Children use their resolved IRI as Document IRI and the same explicit resolver.
+MAX-RESOURCE-DEPTH bounds nested imports (default 32); active cycles are
+Unsupported implementation policy, not a normative XTM invalidity decision.
+Child XML/XTM/model errors retain their original contexts; resolver/import
+failures use XTM-RESOURCE-ERROR with the original ERROR-CAUSE. No supplied Map
+is mutated. Each public call has its own resource recursion context."
+ (check-type max-resource-depth (integer 0 *))
+ (deserialize-document bytes document-iri source-key resource-resolver max-resource-depth nil))
+(defun deserialize-document (bytes document-iri source-key resource-resolver max-resource-depth active-iris)
(check-type bytes (vector (unsigned-byte 8)))
(let ((*document-iri* document-iri) (*source-key* source-key)
(handler (make-instance 'source-handler)))
;; 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))
- (read-topic child map)))
+ (cond ((string= (node-name child) "itemIdentity")
+ (topic-maps.tmdm:add-item-identifier map (leaf-href child)))
+ ((string= (node-name child) "mergeMap")
+ (read-mergemap child map resource-resolver max-resource-depth
+ (cons document-iri active-iris)))
+ (t (read-topic child map))))
map)))