+;;; Document-local association, not a second XML or Topic Maps model. The
+;;; opaque context is NEVER supplied by callers or reused between documents.
+(defstruct xml-resource-binding document-iri source-key original snapshot nodes indices values)
+(defvar *xml-resource-binding* nil)
+(defun source-resource-nodes (node)
+ ;; Same expanded-name predicate and complete preorder as XML's documented
+ ;; RESOURCE-DATA-COUNT / CANONICALIZE-RESOURCE-DATA. Do not count only anyType
+ ;; or skip foreign subtrees: every resourceData slot affects the ordinal.
+ (append (when (and (equal (node-uri node) +namespace+) (equal (node-name node) "resourceData")) (list node))
+ (loop for child in (node-children node) unless (stringp child) append (source-resource-nodes child))))
+(defun resource-association-error (detail)
+ ;; Internal association failure, not a claim that valid XTM is syntactically
+ ;; invalid. There is no native source span for this invariant; use NIL.
+ (error 'xtm-xml-error :code :resource-data-association :detail detail :cause nil
+ :document-iri *document-iri* :source-key *source-key* :line nil :column nil))
+(defun prepare-xml-resources (root original snapshot)
+ (let* ((nodes (coerce (source-resource-nodes root) 'vector))
+ (any (find +any-type+ nodes :test #'equal :key (lambda (n) (attr n "datatype")))))
+ (when any
+ (unless (equalp original snapshot) (resource-association-error "Original XML octets changed after source parsing."))
+ ;; Provenance is established by construction: this private call uses only
+ ;; the octet snapshot taken BEFORE parsing this source tree. No DOM/private
+ ;; XML API or reconstructed XML is used for association or canonicalization.
+ (let* ((context (topic-maps.xml:parse-canonical-context snapshot))
+ (indices (make-hash-table :test #'eq))
+ (values (make-array (length nodes) :initial-element nil)))
+ (unless (= (length nodes) (topic-maps.xml:resource-data-count context))
+ (resource-association-error "Source/context resourceData inventories disagree."))
+ (loop for n across nodes for i from 0 do
+ (when (nth-value 1 (gethash n indices)) (resource-association-error "Source resourceData node occurs twice."))
+ (setf (gethash n indices) i)
+ (when (equal (attr n "datatype") +any-type+)
+ (setf (aref values i)
+ (handler-case (topic-maps.xml:canonicalize-resource-data context :index i)
+ (topic-maps.xml:canonicalization-error (c)
+ (error 'xtm-xml-error :code (topic-maps.xml:canonicalization-error-code c)
+ :detail (princ-to-string c) :cause c :document-iri *document-iri* :source-key *source-key*
+ :line nil :column nil))))))
+ (unless (equalp original snapshot) (resource-association-error "Original XML octets changed during context preparation."))
+ (make-xml-resource-binding :document-iri (copy-seq *document-iri*) :source-key (if (stringp *source-key*) (copy-seq *source-key*) *source-key*)
+ :original original :snapshot snapshot :nodes nodes :indices indices :values values)))))
+(defun bound-xml-value (node)
+ (let ((b *xml-resource-binding*))
+ (unless (and b (equal *document-iri* (xml-resource-binding-document-iri b))
+ (equal *source-key* (xml-resource-binding-source-key b))
+ (equalp (xml-resource-binding-original b) (xml-resource-binding-snapshot b)))
+ (resource-association-error "No matching immutable XML document frame."))
+ (multiple-value-bind (index found) (gethash node (xml-resource-binding-indices b))
+ (unless (and found (typep index '(integer 0 *)) (< index (length (xml-resource-binding-nodes b)))
+ (eq node (aref (xml-resource-binding-nodes b) index))
+ (stringp (aref (xml-resource-binding-values b) index)))
+ (resource-association-error "resourceData is not owned by this document/ordinal."))
+ (aref (xml-resource-binding-values b) index))))
+(defun validate-embedded-markup (node)
+ ;; XTM 4.3.1 any-markup excludes elements in the XTM namespace at EVERY
+ ;; depth; arbitrary foreign elements/attributes remain XML, not XTM syntax.
+ (when (equal (node-uri node) +namespace+)
+ (reject :embedded-xtm-element "XTM elements cannot occur inside embedded XML." node))
+ (dolist (child (node-children node))
+ (unless (stringp child) (validate-embedded-markup child))))
+