xq-lsp 1.0.0 → 1.2.0

package/builtins/builtins-fn.xq

@@ -1,19 +1,32 @@
-module namespace fn="http://www.w3.org/2005/xpath-functions";
+module namespace fn = "http://www.w3.org/2005/xpath-functions";
 
 (: ── Accessors ──────────────────────────────────────────────────────────────── :)
 
-(:~ Returns the name of a node as a QName. :)
+(:~
+ : Returns the name of a node as a QName.
+ :)
 declare function fn:node-name() as xs:QName? external;
-(:~ @param $arg The node whose name to return :)
+
+(:~
+ : @param $arg The node whose name to return
+ :)
 declare function fn:node-name($arg as node()?) as xs:QName? external;
 
-(:~ Returns true if the element has been nilled. :)
+(:~
+ : Returns true if the element has been nilled.
+ :)
 declare function fn:nilled() as xs:boolean? external;
-(:~ @param $arg The node to test :)
+
+(:~
+ : @param $arg The node to test
+ :)
 declare function fn:nilled($arg as node()?) as xs:boolean? external;
 
-(:~ Returns the string value of the context item. :)
+(:~
+ : Returns the string value of the context item.
+ :)
 declare function fn:string() as xs:string external;
+
 (:~
  : Returns the string value of an item.
  : @param $arg The item to convert to string
@@ -21,8 +34,11 @@ declare function fn:string() as xs:string external;
  :)
 declare function fn:string($arg as item()?) as xs:string external;
 
-(:~ Atomizes the context item. :)
+(:~
+ : Atomizes the context item.
+ :)
 declare function fn:data() as xs:anyAtomicType* external;
+
 (:~
  : Atomizes a sequence, extracting typed values from nodes.
  : @param $arg The sequence to atomize
@@ -30,8 +46,11 @@ declare function fn:data() as xs:anyAtomicType* external;
  :)
 declare function fn:data($arg as item()*) as xs:anyAtomicType* external;
 
-(:~ Returns the base URI of the context node. :)
+(:~
+ : Returns the base URI of the context node.
+ :)
 declare function fn:base-uri() as xs:anyURI? external;
+
 (:~
  : Returns the base URI of a node.
  : @param $arg The node
@@ -39,8 +58,11 @@ declare function fn:base-uri() as xs:anyURI? external;
  :)
 declare function fn:base-uri($arg as node()?) as xs:anyURI? external;
 
-(:~ Returns the document URI of the context node. :)
+(:~
+ : Returns the document URI of the context node.
+ :)
 declare function fn:document-uri() as xs:anyURI? external;
+
 (:~
  : Returns the document URI of a document node.
  : @param $arg The document node
@@ -50,14 +72,37 @@ declare function fn:document-uri($arg as node()?) as xs:anyURI? external;
 
 (: ── Error and diagnostics ─────────────────────────────────────────────────── :)
 
-(:~ Raises a dynamic error. :)
+(:~
+ : Raises a dynamic error.
+ :)
 declare function fn:error() as empty-sequence() external;
-(:~ @param $code Error code :)
+
+(:~
+ : @param $code Error code
+ :)
 declare function fn:error($code as xs:QName?) as empty-sequence() external;
-(:~ @param $code Error code @param $description Error message :)
+
+(:~
+ : @param $code Error code @param $description Error message
+ :)
 declare function fn:error($code as xs:QName?, $description as xs:string) as empty-sequence() external;
-(:~ @param $code Error code @param $description Error message @param $error-object Additional error data :)
-declare function fn:error($code as xs:QName?, $description as xs:string, $error-object as item()*) as empty-sequence() external;
+
+(:~
+ : @param $code Error code @param $description Error message @param $error-object Additional error data
+ :)
+declare function fn:error(
+	$code as xs:QName?,
+	$description as xs:string,
+	$error-object as item()*
+) as empty-sequence() external;
+
+(:~
+ : Returns the value of the first argument unchanged and emits a diagnostic trace message.
+ : @param $value The value to return unchanged
+ : @param $label A label for the trace output
+ : @return The input value
+ :)
+declare function fn:trace($value as item()*) as item()* external;
 
 (:~
  : Returns the value of the first argument unchanged and emits a diagnostic trace message.
@@ -96,6 +141,7 @@ declare function fn:floor($arg as xs:numeric?) as xs:numeric? external;
  : @return The nearest integer
  :)
 declare function fn:round($arg as xs:numeric?) as xs:numeric? external;
+
 (:~
  : Rounds a number to a specified precision.
  : @param $arg The number to round
@@ -110,6 +156,7 @@ declare function fn:round($arg as xs:numeric?, $precision as xs:integer) as xs:n
  : @return The rounded number
  :)
 declare function fn:round-half-to-even($arg as xs:numeric?) as xs:numeric? external;
+
 (:~
  : @param $arg The number to round
  : @param $precision Number of decimal places
@@ -123,7 +170,10 @@ declare function fn:round-half-to-even($arg as xs:numeric?, $precision as xs:int
  : @return The value as xs:double, or NaN if not convertible
  :)
 declare function fn:number($arg as xs:anyAtomicType?) as xs:double external;
-(:~ Returns the numeric value of the context item. :)
+
+(:~
+ : Returns the numeric value of the context item.
+ :)
 declare function fn:number() as xs:double external;
 
 (:~
@@ -133,13 +183,18 @@ declare function fn:number() as xs:double external;
  : @return The formatted string
  :)
 declare function fn:format-number($value as xs:numeric?, $picture as xs:string) as xs:string external;
+
 (:~
  : @param $value The number to format
  : @param $picture The picture string
  : @param $decimal-format-name Named decimal format to use
  : @return The formatted string
  :)
-declare function fn:format-number($value as xs:numeric?, $picture as xs:string, $decimal-format-name as xs:string) as xs:string external;
+declare function fn:format-number(
+	$value as xs:numeric?,
+	$picture as xs:string,
+	$decimal-format-name as xs:string
+) as xs:string external;
 
 (: ── String functions ───────────────────────────────────────────────────────── :)
 
@@ -164,13 +219,18 @@ declare function fn:string-to-codepoints($arg as xs:string?) as xs:integer* exte
  : @return -1, 0, or 1
  :)
 declare function fn:compare($comparand1 as xs:string?, $comparand2 as xs:string?) as xs:integer? external;
+
 (:~
  : @param $comparand1 First string
  : @param $comparand2 Second string
  : @param $collation Collation URI
  : @return -1, 0, or 1
  :)
-declare function fn:compare($comparand1 as xs:string?, $comparand2 as xs:string?, $collation as xs:string) as xs:integer? external;
+declare function fn:compare(
+	$comparand1 as xs:string?,
+	$comparand2 as xs:string?,
+	$collation as xs:string
+) as xs:integer? external;
 
 (:~
  : Tests equality of two strings using Unicode codepoint comparison.
@@ -185,6 +245,7 @@ declare function fn:codepoint-equal($comparand1 as xs:string?, $comparand2 as xs
  : @param $arg1 First string
  : @param $arg2 Second string
  : @return Concatenated string
+ : @variadic
  :)
 declare function fn:concat($arg1 as xs:anyAtomicType?, $arg2 as xs:anyAtomicType?) as xs:string external;
 
@@ -194,6 +255,7 @@ declare function fn:concat($arg1 as xs:anyAtomicType?, $arg2 as xs:anyAtomicType
  : @return The joined string
  :)
 declare function fn:string-join($arg1 as xs:anyAtomicType*) as xs:string external;
+
 (:~
  : Joins a sequence of strings using a separator.
  : @param $arg1 The strings to join
@@ -209,6 +271,7 @@ declare function fn:string-join($arg1 as xs:anyAtomicType*, $arg2 as xs:string)
  : @return The substring
  :)
 declare function fn:substring($sourceString as xs:string?, $start as xs:double) as xs:string external;
+
 (:~
  : Returns a substring of specified length starting at a position.
  : @param $sourceString The source string
@@ -216,10 +279,17 @@ declare function fn:substring($sourceString as xs:string?, $start as xs:double)
  : @param $length Number of characters
  : @return The substring
  :)
-declare function fn:substring($sourceString as xs:string?, $start as xs:double, $length as xs:double) as xs:string external;
+declare function fn:substring(
+	$sourceString as xs:string?,
+	$start as xs:double,
+	$length as xs:double
+) as xs:string external;
 
-(:~ Returns the length of the context item string value. :)
+(:~
+ : Returns the length of the context item string value.
+ :)
 declare function fn:string-length() as xs:integer external;
+
 (:~
  : Returns the number of characters in a string.
  : @param $arg The input string
@@ -227,8 +297,11 @@ declare function fn:string-length() as xs:integer external;
  :)
 declare function fn:string-length($arg as xs:string?) as xs:integer external;
 
-(:~ Strips leading and trailing whitespace from the context item. :)
+(:~
+ : Strips leading and trailing whitespace from the context item.
+ :)
 declare function fn:normalize-space() as xs:string external;
+
 (:~
  : Strips leading and trailing whitespace and collapses internal whitespace.
  : @param $arg The input string
@@ -242,6 +315,7 @@ declare function fn:normalize-space($arg as xs:string?) as xs:string external;
  : @return The normalized string (NFC form)
  :)
 declare function fn:normalize-unicode($arg as xs:string?) as xs:string external;
+
 (:~
  : @param $arg The input string
  : @param $normalizationForm Normalization form: NFC, NFD, NFKC, NFKD, FULLY-NORMALIZED
@@ -270,7 +344,11 @@ declare function fn:lower-case($arg as xs:string?) as xs:string external;
  : @param $transString Replacement characters
  : @return The translated string
  :)
-declare function fn:translate($arg as xs:string?, $mapString as xs:string, $transString as xs:string) as xs:string external;
+declare function fn:translate(
+	$arg as xs:string?,
+	$mapString as xs:string,
+	$transString as xs:string
+) as xs:string external;
 
 (:~
  : Encodes a string for use in a URI component.
@@ -300,7 +378,10 @@ declare function fn:escape-html-uri($uri as xs:string?) as xs:string external;
  : @return true if $arg1 contains $arg2
  :)
 declare function fn:contains($arg1 as xs:string?, $arg2 as xs:string?) as xs:boolean external;
-(:~ @param $arg1 The string to search @param $arg2 The substring @param $collation Collation URI :)
+
+(:~
+ : @param $arg1 The string to search @param $arg2 The substring @param $collation Collation URI
+ :)
 declare function fn:contains($arg1 as xs:string?, $arg2 as xs:string?, $collation as xs:string) as xs:boolean external;
 
 (:~
@@ -310,8 +391,15 @@ declare function fn:contains($arg1 as xs:string?, $arg2 as xs:string?, $collatio
  : @return true if $arg1 starts with $arg2
  :)
 declare function fn:starts-with($arg1 as xs:string?, $arg2 as xs:string?) as xs:boolean external;
-(:~ @param $arg1 The string @param $arg2 The prefix @param $collation Collation URI :)
-declare function fn:starts-with($arg1 as xs:string?, $arg2 as xs:string?, $collation as xs:string) as xs:boolean external;
+
+(:~
+ : @param $arg1 The string @param $arg2 The prefix @param $collation Collation URI
+ :)
+declare function fn:starts-with(
+	$arg1 as xs:string?,
+	$arg2 as xs:string?,
+	$collation as xs:string
+) as xs:boolean external;
 
 (:~
  : Tests whether a string ends with a given suffix.
@@ -320,7 +408,10 @@ declare function fn:starts-with($arg1 as xs:string?, $arg2 as xs:string?, $colla
  : @return true if $arg1 ends with $arg2
  :)
 declare function fn:ends-with($arg1 as xs:string?, $arg2 as xs:string?) as xs:boolean external;
-(:~ @param $arg1 The string @param $arg2 The suffix @param $collation Collation URI :)
+
+(:~
+ : @param $arg1 The string @param $arg2 The suffix @param $collation Collation URI
+ :)
 declare function fn:ends-with($arg1 as xs:string?, $arg2 as xs:string?, $collation as xs:string) as xs:boolean external;
 
 (:~
@@ -330,8 +421,15 @@ declare function fn:ends-with($arg1 as xs:string?, $arg2 as xs:string?, $collati
  : @return The substring before the pattern
  :)
 declare function fn:substring-before($arg1 as xs:string?, $arg2 as xs:string?) as xs:string external;
-(:~ @param $arg1 Input @param $arg2 Pattern @param $collation Collation URI :)
-declare function fn:substring-before($arg1 as xs:string?, $arg2 as xs:string?, $collation as xs:string) as xs:string external;
+
+(:~
+ : @param $arg1 Input @param $arg2 Pattern @param $collation Collation URI
+ :)
+declare function fn:substring-before(
+	$arg1 as xs:string?,
+	$arg2 as xs:string?,
+	$collation as xs:string
+) as xs:string external;
 
 (:~
  : Returns the part of a string that follows the first occurrence of a pattern.
@@ -340,8 +438,15 @@ declare function fn:substring-before($arg1 as xs:string?, $arg2 as xs:string?, $
  : @return The substring after the pattern
  :)
 declare function fn:substring-after($arg1 as xs:string?, $arg2 as xs:string?) as xs:string external;
-(:~ @param $arg1 Input @param $arg2 Pattern @param $collation Collation URI :)
-declare function fn:substring-after($arg1 as xs:string?, $arg2 as xs:string?, $collation as xs:string) as xs:string external;
+
+(:~
+ : @param $arg1 Input @param $arg2 Pattern @param $collation Collation URI
+ :)
+declare function fn:substring-after(
+	$arg1 as xs:string?,
+	$arg2 as xs:string?,
+	$collation as xs:string
+) as xs:string external;
 
 (:~
  : Tests whether a string matches a regular expression.
@@ -350,7 +455,10 @@ declare function fn:substring-after($arg1 as xs:string?, $arg2 as xs:string?, $c
  : @return true if the string matches
  :)
 declare function fn:matches($input as xs:string?, $pattern as xs:string) as xs:boolean external;
-(:~ @param $input The string @param $pattern The regex @param $flags Flags (i, m, s, x) :)
+
+(:~
+ : @param $input The string @param $pattern The regex @param $flags Flags (i, m, s, x)
+ :)
 declare function fn:matches($input as xs:string?, $pattern as xs:string, $flags as xs:string) as xs:boolean external;
 
 (:~
@@ -360,9 +468,21 @@ declare function fn:matches($input as xs:string?, $pattern as xs:string, $flags
  : @param $replacement The replacement string (may use $0, $1 … back-references)
  : @return The modified string
  :)
-declare function fn:replace($input as xs:string?, $pattern as xs:string, $replacement as xs:string) as xs:string external;
-(:~ @param $input Input @param $pattern Regex @param $replacement Replacement @param $flags Flags :)
-declare function fn:replace($input as xs:string?, $pattern as xs:string, $replacement as xs:string, $flags as xs:string) as xs:string external;
+declare function fn:replace(
+	$input as xs:string?,
+	$pattern as xs:string,
+	$replacement as xs:string
+) as xs:string external;
+
+(:~
+ : @param $input Input @param $pattern Regex @param $replacement Replacement @param $flags Flags
+ :)
+declare function fn:replace(
+	$input as xs:string?,
+	$pattern as xs:string,
+	$replacement as xs:string,
+	$flags as xs:string
+) as xs:string external;
 
 (:~
  : Splits a string on whitespace, returning a sequence of tokens.
@@ -370,6 +490,7 @@ declare function fn:replace($input as xs:string?, $pattern as xs:string, $replac
  : @return Sequence of token strings
  :)
 declare function fn:tokenize($input as xs:string?) as xs:string* external;
+
 (:~
  : Splits a string on a regex delimiter.
  : @param $input The input string
@@ -377,7 +498,10 @@ declare function fn:tokenize($input as xs:string?) as xs:string* external;
  : @return Sequence of token strings
  :)
 declare function fn:tokenize($input as xs:string?, $pattern as xs:string) as xs:string* external;
-(:~ @param $input Input @param $pattern Delimiter @param $flags Flags :)
+
+(:~
+ : @param $input Input @param $pattern Delimiter @param $flags Flags
+ :)
 declare function fn:tokenize($input as xs:string?, $pattern as xs:string, $flags as xs:string) as xs:string* external;
 
 (:~
@@ -387,8 +511,15 @@ declare function fn:tokenize($input as xs:string?, $pattern as xs:string, $flags
  : @return An fn:analyze-string-result element
  :)
 declare function fn:analyze-string($input as xs:string?, $pattern as xs:string) as element() external;
-(:~ @param $input Input @param $pattern Regex @param $flags Flags :)
-declare function fn:analyze-string($input as xs:string?, $pattern as xs:string, $flags as xs:string) as element() external;
+
+(:~
+ : @param $input Input @param $pattern Regex @param $flags Flags
+ :)
+declare function fn:analyze-string(
+	$input as xs:string?,
+	$pattern as xs:string,
+	$flags as xs:string
+) as element() external;
 
 (: ── URI functions ──────────────────────────────────────────────────────────── :)
 
@@ -398,6 +529,7 @@ declare function fn:analyze-string($input as xs:string?, $pattern as xs:string,
  : @return The resolved absolute URI
  :)
 declare function fn:resolve-uri($relative as xs:string?) as xs:anyURI? external;
+
 (:~
  : Resolves a relative URI against a given base URI.
  : @param $relative The relative URI reference
@@ -495,13 +627,18 @@ declare function fn:reverse($arg as item()*) as item()* external;
  : @return Items from $startingLoc to the end
  :)
 declare function fn:subsequence($sourceSeq as item()*, $startingLoc as xs:double) as item()* external;
+
 (:~
  : @param $sourceSeq The source sequence
  : @param $startingLoc 1-based start position
  : @param $length Number of items to return
  : @return The subsequence
  :)
-declare function fn:subsequence($sourceSeq as item()*, $startingLoc as xs:double, $length as xs:double) as item()* external;
+declare function fn:subsequence(
+	$sourceSeq as item()*,
+	$startingLoc as xs:double,
+	$length as xs:double
+) as item()* external;
 
 (:~
  : Returns the items in an implementation-defined order.
@@ -537,7 +674,10 @@ declare function fn:exactly-one($arg as item()*) as item() external;
  : @return Sequence with duplicates removed
  :)
 declare function fn:distinct-values($arg as xs:anyAtomicType*) as xs:anyAtomicType* external;
-(:~ @param $arg The sequence @param $collation Collation URI :)
+
+(:~
+ : @param $arg The sequence @param $collation Collation URI
+ :)
 declare function fn:distinct-values($arg as xs:anyAtomicType*, $collation as xs:string) as xs:anyAtomicType* external;
 
 (:~
@@ -547,8 +687,15 @@ declare function fn:distinct-values($arg as xs:anyAtomicType*, $collation as xs:
  : @return Sequence of 1-based positions
  :)
 declare function fn:index-of($seq as xs:anyAtomicType*, $search as xs:anyAtomicType) as xs:integer* external;
-(:~ @param $seq Sequence @param $search Value @param $collation Collation URI :)
-declare function fn:index-of($seq as xs:anyAtomicType*, $search as xs:anyAtomicType, $collation as xs:string) as xs:integer* external;
+
+(:~
+ : @param $seq Sequence @param $search Value @param $collation Collation URI
+ :)
+declare function fn:index-of(
+	$seq as xs:anyAtomicType*,
+	$search as xs:anyAtomicType,
+	$collation as xs:string
+) as xs:integer* external;
 
 (:~
  : Tests whether two sequences are deeply equal.
@@ -557,8 +704,15 @@ declare function fn:index-of($seq as xs:anyAtomicType*, $search as xs:anyAtomicT
  : @return true if the sequences are deeply equal
  :)
 declare function fn:deep-equal($parameter1 as item()*, $parameter2 as item()*) as xs:boolean external;
-(:~ @param $parameter1 First @param $parameter2 Second @param $collation Collation URI :)
-declare function fn:deep-equal($parameter1 as item()*, $parameter2 as item()*, $collation as xs:string) as xs:boolean external;
+
+(:~
+ : @param $parameter1 First @param $parameter2 Second @param $collation Collation URI
+ :)
+declare function fn:deep-equal(
+	$parameter1 as item()*,
+	$parameter2 as item()*,
+	$collation as xs:string
+) as xs:boolean external;
 
 (:~
  : Returns the number of items in a sequence.
@@ -580,7 +734,10 @@ declare function fn:avg($arg as xs:anyAtomicType*) as xs:anyAtomicType? external
  : @return The maximum value
  :)
 declare function fn:max($arg as xs:anyAtomicType*) as xs:anyAtomicType? external;
-(:~ @param $arg Sequence @param $collation Collation URI :)
+
+(:~
+ : @param $arg Sequence @param $collation Collation URI
+ :)
 declare function fn:max($arg as xs:anyAtomicType*, $collation as xs:string) as xs:anyAtomicType? external;
 
 (:~
@@ -589,7 +746,10 @@ declare function fn:max($arg as xs:anyAtomicType*, $collation as xs:string) as x
  : @return The minimum value
  :)
 declare function fn:min($arg as xs:anyAtomicType*) as xs:anyAtomicType? external;
-(:~ @param $arg Sequence @param $collation Collation URI :)
+
+(:~
+ : @param $arg Sequence @param $collation Collation URI
+ :)
 declare function fn:min($arg as xs:anyAtomicType*, $collation as xs:string) as xs:anyAtomicType? external;
 
 (:~
@@ -598,6 +758,7 @@ declare function fn:min($arg as xs:anyAtomicType*, $collation as xs:string) as x
  : @return The sum, or 0 if empty
  :)
 declare function fn:sum($arg as xs:anyAtomicType*) as xs:anyAtomicType external;
+
 (:~
  : @param $arg The sequence
  : @param $zero Value to return for an empty sequence
@@ -613,7 +774,7 @@ declare function fn:sum($arg as xs:anyAtomicType*, $zero as xs:anyAtomicType?) a
  : @param $action Function to apply to each item
  : @return Concatenated results
  :)
-declare function fn:for-each($seq as item()*, $action as function(item()) as item()*) as item()* external;
+declare function fn:for-each($seq as item()*, $action as function (item()) as item()*) as item()* external;
 
 (:~
  : Returns items from a sequence for which a predicate is true.
@@ -621,7 +782,7 @@ declare function fn:for-each($seq as item()*, $action as function(item()) as ite
  : @param $f Predicate function
  : @return Items where $f returns true
  :)
-declare function fn:filter($seq as item()*, $f as function(item()) as xs:boolean) as item()* external;
+declare function fn:filter($seq as item()*, $f as function (item()) as xs:boolean) as item()* external;
 
 (:~
  : Reduces a sequence to a single value by applying a function from the left.
@@ -630,7 +791,11 @@ declare function fn:filter($seq as item()*, $f as function(item()) as xs:boolean
  : @param $f Combining function
  : @return The accumulated result
  :)
-declare function fn:fold-left($seq as item()*, $zero as item()*, $f as function(item()*, item()) as item()*) as item()* external;
+declare function fn:fold-left(
+	$seq as item()*,
+	$zero as item()*,
+	$f as function (item()*, item()) as item()*
+) as item()* external;
 
 (:~
  : Reduces a sequence to a single value by applying a function from the right.
@@ -639,7 +804,11 @@ declare function fn:fold-left($seq as item()*, $zero as item()*, $f as function(
  : @param $f Combining function
  : @return The accumulated result
  :)
-declare function fn:fold-right($seq as item()*, $zero as item()*, $f as function(item(), item()*) as item()*) as item()* external;
+declare function fn:fold-right(
+	$seq as item()*,
+	$zero as item()*,
+	$f as function (item(), item()*) as item()*
+) as item()* external;
 
 (:~
  : Applies a function pairwise to two sequences.
@@ -648,7 +817,11 @@ declare function fn:fold-right($seq as item()*, $zero as item()*, $f as function
  : @param $action Function to apply to each pair
  : @return Concatenated results
  :)
-declare function fn:for-each-pair($seq1 as item()*, $seq2 as item()*, $action as function(item(), item()) as item()*) as item()* external;
+declare function fn:for-each-pair(
+	$seq1 as item()*,
+	$seq2 as item()*,
+	$action as function (item(), item()) as item()*
+) as item()* external;
 
 (:~
  : Sorts a sequence using the default collation and natural ordering.
@@ -656,15 +829,23 @@ declare function fn:for-each-pair($seq1 as item()*, $seq2 as item()*, $action as
  : @return The sorted sequence
  :)
 declare function fn:sort($seq as item()*) as item()* external;
-(:~ @param $seq Sequence @param $collation Collation URI or empty :)
+
+(:~
+ : @param $seq Sequence @param $collation Collation URI or empty
+ :)
 declare function fn:sort($seq as item()*, $collation as xs:string?) as item()* external;
+
 (:~
  : @param $seq Sequence
  : @param $collation Collation URI or empty
  : @param $key Function that extracts the sort key from an item
  : @return The sorted sequence
  :)
-declare function fn:sort($seq as item()*, $collation as xs:string?, $key as function(item()) as xs:anyAtomicType*) as item()* external;
+declare function fn:sort(
+	$seq as item()*,
+	$collation as xs:string?,
+	$key as function (item()) as xs:anyAtomicType*
+) as item()* external;
 
 (:~
  : Calls a function with arguments supplied as an array.
@@ -754,8 +935,11 @@ declare function fn:local-name-from-QName($arg as xs:QName?) as xs:NCName? exter
 
 (: ── Node functions ─────────────────────────────────────────────────────────── :)
 
-(:~ Returns the name of the context node as a string. :)
+(:~
+ : Returns the name of the context node as a string.
+ :)
 declare function fn:name() as xs:string external;
+
 (:~
  : Returns the name of a node as a string.
  : @param $arg The node
@@ -763,8 +947,11 @@ declare function fn:name() as xs:string external;
  :)
 declare function fn:name($arg as node()?) as xs:string external;
 
-(:~ Returns the local name of the context node. :)
+(:~
+ : Returns the local name of the context node.
+ :)
 declare function fn:local-name() as xs:string external;
+
 (:~
  : Returns the local name of a node.
  : @param $arg The node
@@ -772,8 +959,11 @@ declare function fn:local-name() as xs:string external;
  :)
 declare function fn:local-name($arg as node()?) as xs:string external;
 
-(:~ Returns the namespace URI of the context node. :)
+(:~
+ : Returns the namespace URI of the context node.
+ :)
 declare function fn:namespace-uri() as xs:anyURI external;
+
 (:~
  : Returns the namespace URI of a node.
  : @param $arg The node
@@ -787,11 +977,17 @@ declare function fn:namespace-uri($arg as node()?) as xs:anyURI external;
  : @return true if the node's language matches
  :)
 declare function fn:lang($testlang as xs:string?) as xs:boolean external;
-(:~ @param $testlang Language @param $node The node to test :)
+
+(:~
+ : @param $testlang Language @param $node The node to test
+ :)
 declare function fn:lang($testlang as xs:string?, $node as node()) as xs:boolean external;
 
-(:~ Returns the root of the tree containing the context node. :)
+(:~
+ : Returns the root of the tree containing the context node.
+ :)
 declare function fn:root() as node() external;
+
 (:~
  : Returns the root of the tree containing a node.
  : @param $arg The node
@@ -799,8 +995,11 @@ declare function fn:root() as node() external;
  :)
 declare function fn:root($arg as node()?) as node()? external;
 
-(:~ Returns the path to the context node. :)
+(:~
+ : Returns the path to the context node.
+ :)
 declare function fn:path() as xs:string? external;
+
 (:~
  : Returns an XPath expression that uniquely identifies a node within its document.
  : @param $arg The node
@@ -808,8 +1007,11 @@ declare function fn:path() as xs:string? external;
  :)
 declare function fn:path($arg as node()?) as xs:string? external;
 
-(:~ Tests whether the context node has child nodes. :)
+(:~
+ : Tests whether the context node has child nodes.
+ :)
 declare function fn:has-children() as xs:boolean external;
+
 (:~
  : Tests whether a node has child nodes.
  : @param $node The node to test
@@ -831,8 +1033,11 @@ declare function fn:innermost($nodes as node()*) as node()* external;
  :)
 declare function fn:outermost($nodes as node()*) as node()* external;
 
-(:~ Generates a unique ID string for the context node. :)
+(:~
+ : Generates a unique ID string for the context node.
+ :)
 declare function fn:generate-id() as xs:string external;
+
 (:~
  : Generates a unique ID string for a node.
  : @param $arg The node
@@ -906,50 +1111,109 @@ declare function fn:static-base-uri() as xs:anyURI? external;
  :)
 declare function fn:dateTime($arg1 as xs:date?, $arg2 as xs:time?) as xs:dateTime? external;
 
-(:~ @param $arg A duration @return The years component :)
+(:~
+ : @param $arg A duration @return The years component
+ :)
 declare function fn:years-from-duration($arg as xs:duration?) as xs:integer? external;
-(:~ @param $arg A duration @return The months component :)
+
+(:~
+ : @param $arg A duration @return The months component
+ :)
 declare function fn:months-from-duration($arg as xs:duration?) as xs:integer? external;
-(:~ @param $arg A duration @return The days component :)
+
+(:~
+ : @param $arg A duration @return The days component
+ :)
 declare function fn:days-from-duration($arg as xs:duration?) as xs:integer? external;
-(:~ @param $arg A duration @return The hours component :)
+
+(:~
+ : @param $arg A duration @return The hours component
+ :)
 declare function fn:hours-from-duration($arg as xs:duration?) as xs:integer? external;
-(:~ @param $arg A duration @return The minutes component :)
+
+(:~
+ : @param $arg A duration @return The minutes component
+ :)
 declare function fn:minutes-from-duration($arg as xs:duration?) as xs:integer? external;
-(:~ @param $arg A duration @return The seconds component :)
+
+(:~
+ : @param $arg A duration @return The seconds component
+ :)
 declare function fn:seconds-from-duration($arg as xs:duration?) as xs:decimal? external;
 
-(:~ @param $arg A dateTime @return The year component :)
+(:~
+ : @param $arg A dateTime @return The year component
+ :)
 declare function fn:year-from-dateTime($arg as xs:dateTime?) as xs:integer? external;
-(:~ @param $arg A dateTime @return The month component (1–12) :)
+
+(:~
+ : @param $arg A dateTime @return The month component (1–12)
+ :)
 declare function fn:month-from-dateTime($arg as xs:dateTime?) as xs:integer? external;
-(:~ @param $arg A dateTime @return The day-of-month component (1–31) :)
+
+(:~
+ : @param $arg A dateTime @return The day-of-month component (1–31)
+ :)
 declare function fn:day-from-dateTime($arg as xs:dateTime?) as xs:integer? external;
-(:~ @param $arg A dateTime @return The hours component (0–23) :)
+
+(:~
+ : @param $arg A dateTime @return The hours component (0–23)
+ :)
 declare function fn:hours-from-dateTime($arg as xs:dateTime?) as xs:integer? external;
-(:~ @param $arg A dateTime @return The minutes component (0–59) :)
+
+(:~
+ : @param $arg A dateTime @return The minutes component (0–59)
+ :)
 declare function fn:minutes-from-dateTime($arg as xs:dateTime?) as xs:integer? external;
-(:~ @param $arg A dateTime @return The seconds component :)
+
+(:~
+ : @param $arg A dateTime @return The seconds component
+ :)
 declare function fn:seconds-from-dateTime($arg as xs:dateTime?) as xs:decimal? external;
-(:~ @param $arg A dateTime @return The timezone as a dayTimeDuration :)
+
+(:~
+ : @param $arg A dateTime @return The timezone as a dayTimeDuration
+ :)
 declare function fn:timezone-from-dateTime($arg as xs:dateTime?) as xs:dayTimeDuration? external;
 
-(:~ @param $arg A date @return The year component :)
+(:~
+ : @param $arg A date @return The year component
+ :)
 declare function fn:year-from-date($arg as xs:date?) as xs:integer? external;
-(:~ @param $arg A date @return The month component (1–12) :)
+
+(:~
+ : @param $arg A date @return The month component (1–12)
+ :)
 declare function fn:month-from-date($arg as xs:date?) as xs:integer? external;
-(:~ @param $arg A date @return The day-of-month component (1–31) :)
+
+(:~
+ : @param $arg A date @return The day-of-month component (1–31)
+ :)
 declare function fn:day-from-date($arg as xs:date?) as xs:integer? external;
-(:~ @param $arg A date @return The timezone as a dayTimeDuration :)
+
+(:~
+ : @param $arg A date @return The timezone as a dayTimeDuration
+ :)
 declare function fn:timezone-from-date($arg as xs:date?) as xs:dayTimeDuration? external;
 
-(:~ @param $arg A time @return The hours component (0–23) :)
+(:~
+ : @param $arg A time @return The hours component (0–23)
+ :)
 declare function fn:hours-from-time($arg as xs:time?) as xs:integer? external;
-(:~ @param $arg A time @return The minutes component (0–59) :)
+
+(:~
+ : @param $arg A time @return The minutes component (0–59)
+ :)
 declare function fn:minutes-from-time($arg as xs:time?) as xs:integer? external;
-(:~ @param $arg A time @return The seconds component :)
+
+(:~
+ : @param $arg A time @return The seconds component
+ :)
 declare function fn:seconds-from-time($arg as xs:time?) as xs:decimal? external;
-(:~ @param $arg A time @return The timezone as a dayTimeDuration :)
+
+(:~
+ : @param $arg A time @return The timezone as a dayTimeDuration
+ :)
 declare function fn:timezone-from-time($arg as xs:time?) as xs:dayTimeDuration? external;
 
 (:~
@@ -958,22 +1222,36 @@ declare function fn:timezone-from-time($arg as xs:time?) as xs:dayTimeDuration?
  : @return The adjusted dateTime
  :)
 declare function fn:adjust-dateTime-to-timezone($arg as xs:dateTime?) as xs:dateTime? external;
+
 (:~
  : Adjusts a dateTime to a given timezone.
  : @param $arg The dateTime to adjust
  : @param $timezone The target timezone, or empty sequence to remove timezone
  : @return The adjusted dateTime
  :)
-declare function fn:adjust-dateTime-to-timezone($arg as xs:dateTime?, $timezone as xs:dayTimeDuration?) as xs:dateTime? external;
+declare function fn:adjust-dateTime-to-timezone(
+	$arg as xs:dateTime?,
+	$timezone as xs:dayTimeDuration?
+) as xs:dateTime? external;
 
-(:~ @param $arg Date to adjust @return Adjusted to implicit timezone :)
+(:~
+ : @param $arg Date to adjust @return Adjusted to implicit timezone
+ :)
 declare function fn:adjust-date-to-timezone($arg as xs:date?) as xs:date? external;
-(:~ @param $arg Date @param $timezone Target timezone :)
+
+(:~
+ : @param $arg Date @param $timezone Target timezone
+ :)
 declare function fn:adjust-date-to-timezone($arg as xs:date?, $timezone as xs:dayTimeDuration?) as xs:date? external;
 
-(:~ @param $arg Time to adjust @return Adjusted to implicit timezone :)
+(:~
+ : @param $arg Time to adjust @return Adjusted to implicit timezone
+ :)
 declare function fn:adjust-time-to-timezone($arg as xs:time?) as xs:time? external;
-(:~ @param $arg Time @param $timezone Target timezone :)
+
+(:~
+ : @param $arg Time @param $timezone Target timezone
+ :)
 declare function fn:adjust-time-to-timezone($arg as xs:time?, $timezone as xs:dayTimeDuration?) as xs:time? external;
 
 (:~
@@ -983,18 +1261,49 @@ declare function fn:adjust-time-to-timezone($arg as xs:time?, $timezone as xs:da
  : @return The formatted string
  :)
 declare function fn:format-dateTime($value as xs:dateTime?, $picture as xs:string) as xs:string? external;
-(:~ @param $value dateTime @param $picture Picture @param $language Language @param $calendar Calendar @param $place Place :)
-declare function fn:format-dateTime($value as xs:dateTime?, $picture as xs:string, $language as xs:string?, $calendar as xs:string?, $place as xs:string?) as xs:string? external;
 
-(:~ @param $value Date @param $picture Picture @return Formatted date string :)
+(:~
+ : @param $value dateTime @param $picture Picture @param $language Language @param $calendar Calendar @param $place Place
+ :)
+declare function fn:format-dateTime(
+	$value as xs:dateTime?,
+	$picture as xs:string,
+	$language as xs:string?,
+	$calendar as xs:string?,
+	$place as xs:string?
+) as xs:string? external;
+
+(:~
+ : @param $value Date @param $picture Picture @return Formatted date string
+ :)
 declare function fn:format-date($value as xs:date?, $picture as xs:string) as xs:string? external;
-(:~ @param $value Date @param $picture Picture @param $language Language @param $calendar Calendar @param $place Place :)
-declare function fn:format-date($value as xs:date?, $picture as xs:string, $language as xs:string?, $calendar as xs:string?, $place as xs:string?) as xs:string? external;
 
-(:~ @param $value Time @param $picture Picture @return Formatted time string :)
+(:~
+ : @param $value Date @param $picture Picture @param $language Language @param $calendar Calendar @param $place Place
+ :)
+declare function fn:format-date(
+	$value as xs:date?,
+	$picture as xs:string,
+	$language as xs:string?,
+	$calendar as xs:string?,
+	$place as xs:string?
+) as xs:string? external;
+
+(:~
+ : @param $value Time @param $picture Picture @return Formatted time string
+ :)
 declare function fn:format-time($value as xs:time?, $picture as xs:string) as xs:string? external;
-(:~ @param $value Time @param $picture Picture @param $language Language @param $calendar Calendar @param $place Place :)
-declare function fn:format-time($value as xs:time?, $picture as xs:string, $language as xs:string?, $calendar as xs:string?, $place as xs:string?) as xs:string? external;
+
+(:~
+ : @param $value Time @param $picture Picture @param $language Language @param $calendar Calendar @param $place Place
+ :)
+declare function fn:format-time(
+	$value as xs:time?,
+	$picture as xs:string,
+	$language as xs:string?,
+	$calendar as xs:string?,
+	$place as xs:string?
+) as xs:string? external;
 
 (: ── Document and collection functions ──────────────────────────────────────── :)
 
@@ -1012,8 +1321,11 @@ declare function fn:doc($uri as xs:string?) as document-node()? external;
  :)
 declare function fn:doc-available($uri as xs:string?) as xs:boolean external;
 
-(:~ Returns all documents in the default collection. :)
+(:~
+ : Returns all documents in the default collection.
+ :)
 declare function fn:collection() as item()* external;
+
 (:~
  : Returns a collection of documents or nodes.
  : @param $arg The collection URI
@@ -1021,8 +1333,11 @@ declare function fn:collection() as item()* external;
  :)
 declare function fn:collection($arg as xs:string?) as item()* external;
 
-(:~ Returns the URIs in the default URI collection. :)
+(:~
+ : Returns the URIs in the default URI collection.
+ :)
 declare function fn:uri-collection() as xs:anyURI* external;
+
 (:~
  : Returns the URIs in a named URI collection.
  : @param $arg The collection URI
@@ -1036,7 +1351,10 @@ declare function fn:uri-collection($arg as xs:string?) as xs:anyURI* external;
  : @return The file content as a string
  :)
 declare function fn:unparsed-text($href as xs:string?) as xs:string? external;
-(:~ @param $href URI @param $encoding Character encoding :)
+
+(:~
+ : @param $href URI @param $encoding Character encoding
+ :)
 declare function fn:unparsed-text($href as xs:string?, $encoding as xs:string) as xs:string? external;
 
 (:~
@@ -1045,7 +1363,10 @@ declare function fn:unparsed-text($href as xs:string?, $encoding as xs:string) a
  : @return Sequence of line strings
  :)
 declare function fn:unparsed-text-lines($href as xs:string?) as xs:string* external;
-(:~ @param $href URI @param $encoding Character encoding :)
+
+(:~
+ : @param $href URI @param $encoding Character encoding
+ :)
 declare function fn:unparsed-text-lines($href as xs:string?, $encoding as xs:string) as xs:string* external;
 
 (:~
@@ -1054,7 +1375,10 @@ declare function fn:unparsed-text-lines($href as xs:string?, $encoding as xs:str
  : @return true if the resource is available
  :)
 declare function fn:unparsed-text-available($href as xs:string?) as xs:boolean external;
-(:~ @param $href URI @param $encoding Character encoding :)
+
+(:~
+ : @param $href URI @param $encoding Character encoding
+ :)
 declare function fn:unparsed-text-available($href as xs:string?, $encoding as xs:string) as xs:boolean external;
 
 (:~
@@ -1078,7 +1402,10 @@ declare function fn:available-environment-variables() as xs:string* external;
  : @return The matching elements
  :)
 declare function fn:id($arg as xs:string*) as element()* external;
-(:~ @param $arg ID strings @param $node Node in the target document :)
+
+(:~
+ : @param $arg ID strings @param $node Node in the target document
+ :)
 declare function fn:id($arg as xs:string*, $node as node()) as element()* external;
 
 (:~
@@ -1087,7 +1414,10 @@ declare function fn:id($arg as xs:string*, $node as node()) as element()* extern
  : @return The matching nodes
  :)
 declare function fn:idref($arg as xs:string*) as node()* external;
-(:~ @param $arg ID strings @param $node Node in the target document :)
+
+(:~
+ : @param $arg ID strings @param $node Node in the target document
+ :)
 declare function fn:idref($arg as xs:string*, $node as node()) as node()* external;
 
 (:~
@@ -1096,5 +1426,66 @@ declare function fn:idref($arg as xs:string*, $node as node()) as node()* extern
  : @return The matching elements
  :)
 declare function fn:element-with-id($arg as xs:string*) as element()* external;
-(:~ @param $arg ID strings @param $node Node in the target document :)
+
+(:~
+ : @param $arg ID strings @param $node Node in the target document
+ :)
 declare function fn:element-with-id($arg as xs:string*, $node as node()) as element()* external;
+
+(:~
+ : Serializes a sequence of items as a string.
+ : @param $arg The sequence of items to serialize
+ : @return The serialized string
+ :)
+declare function fn:serialize($arg as item()*) as xs:string external;
+
+(:~
+ : Serializes a sequence of items as a string using the given serialization parameters.
+ : @param $arg The sequence of items to serialize
+ : @param $params Serialization parameters (map or element)
+ : @return The serialized string
+ :)
+declare function fn:serialize($arg as item()*, $params as item()?) as xs:string external;
+
+(: ── XQuery 3.0 additions ────────────────────────────────────────────────────── :)
+
+declare function fn:parse-xml($arg as xs:string?) as document-node(element(*))? external;
+
+declare function fn:parse-xml-fragment($arg as xs:string?) as document-node()? external;
+
+declare function fn:format-integer($value as xs:integer?, $picture as xs:string) as xs:string external;
+declare function fn:format-integer($value as xs:integer?, $picture as xs:string, $lang as xs:string) as xs:string external;
+
+(: ── XQuery 3.1 additions ────────────────────────────────────────────────────── :)
+
+declare function fn:json-doc($href as xs:string?) as item()? external;
+declare function fn:json-doc($href as xs:string?, $options as map(*)) as item()? external;
+
+declare function fn:parse-json($json-text as xs:string?) as item()? external;
+declare function fn:parse-json($json-text as xs:string?, $options as map(*)) as item()? external;
+
+declare function fn:json-to-xml($json-text as xs:string?) as document-node()? external;
+declare function fn:json-to-xml($json-text as xs:string?, $options as map(*)) as document-node()? external;
+
+declare function fn:xml-to-json($input as node()?) as xs:string? external;
+declare function fn:xml-to-json($input as node()?, $options as map(*)) as xs:string? external;
+
+declare function fn:parse-ietf-date($value as xs:string?) as xs:dateTime? external;
+
+declare function fn:collation-key($key as xs:string) as xs:base64Binary external;
+declare function fn:collation-key($key as xs:string, $collation as xs:string) as xs:base64Binary external;
+
+declare function fn:contains-token($input as xs:string*, $token as xs:string) as xs:boolean external;
+declare function fn:contains-token($input as xs:string*, $token as xs:string, $collation as xs:string) as xs:boolean external;
+
+declare function fn:random-number-generator() as map(xs:string, item()) external;
+declare function fn:random-number-generator($seed as xs:anyAtomicType?) as map(xs:string, item()) external;
+
+declare function fn:transform($options as map(xs:string, item()*)) as map(xs:string, item()*) external;
+
+declare function fn:load-xquery-module($uri as xs:string) as map(xs:string, item()*) external;
+declare function fn:load-xquery-module($uri as xs:string, $options as map(xs:string, item()*)) as map(xs:string, item()*) external;
+
+(: ── XQuery Update Facility ──────────────────────────────────────────────────── :)
+
+declare function fn:put($node as node(), $uri as xs:string) as empty-sequence() external;