+(defun read-variant (parser map name)
+ "CTM 3.12: required explicit Scope, then union with the current Parent Scope."
+ (consume parser) ; (
+ (multiple-value-bind (value datatype) (read-literal parser :variant)
+ (unless (punctuation-p parser #\@)
+ (problem 'ctm-rejection :expected-variant-scope (token-position (look parser))
+ "A Variant requires an explicit '@' Scope."))
+ (let* ((scope-position (token-position (look parser))) (themes (read-scope parser map))
+ (scope (append (topic-maps.tmdm:topic-name-scope name) themes)))
+ (unless (punctuation-p parser #\))
+ (problem 'ctm-rejection :missing-variant-close (token-position (look parser))
+ "Expected ')' after the Variant Scope."))
+ (consume parser)
+ (handler-case (topic-maps.tmdm:add-variant name value :datatype datatype :scope scope)
+ (topic-maps.tmdm:variant-error (c)
+ (problem 'ctm-rejection (topic-maps.tmdm:variant-error-code c) scope-position (princ-to-string c)))))))
+
+(defun read-name (parser map topic)
+ "CTM 3.11: optional Topic reference plus ':' followed by a string.
+Use the shared Topic reference resolver."
+ (let* ((token (look parser))
+ (typed (topic-reference-start-p token))
+ (type (when typed (topic-reference parser map))))
+ (when typed
+ (unless (punctuation-p parser #\:)
+ (problem 'ctm-rejection :expected-name-type-separator
+ (token-position (look parser)) "Expected ':' after the name type."))
+ (consume parser))
+ (let ((value (consume parser)))
+ (unless (eq :string (token-kind value))
+ (problem 'ctm-rejection :expected-name-value (token-position value)
+ "Expected a quoted name value after '-' or the name type separator."))
+ (let* ((scope (read-scope parser map))
+ (name (if typed
+ (topic-maps.tmdm:add-name topic (token-value value) :type type :scope scope)
+ (topic-maps.tmdm:add-name topic (token-value value) :scope scope))))
+ (loop while (punctuation-p parser #\() do (read-variant parser map name))))
+ (topic-maps.tmdm:canonical-topic topic)))
+
+(defun read-topic-tail (parser map topic terminator &key required)
+ "CTM 3.9: the same Tail reader ends at '.' or the caller's Embedded ']'."
+ (let ((has-tail nil) (seen-tail nil))