xq-lsp 1.8.1 → 1.8.2

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [1.8.2](https://github.com/DrRataplan/xq-lsp/compare/lsp-v1.8.1...lsp-v1.8.2) (2026-09-01)
+
+
+### Bug Fixes
+
+* recover eXist-db functions the generator silently dropped ([6e76557](https://github.com/DrRataplan/xq-lsp/commit/6e765574bb484fa650ab83cf33ee301686b92604))
+* use an explicit textEdit for auto-declare-namespace completions ([b319917](https://github.com/DrRataplan/xq-lsp/commit/b3199170a138bc2281cff86bbd4368b0d1c5b9f7))
+
 ## [1.8.1](https://github.com/DrRataplan/xq-lsp/compare/lsp-v1.8.0...lsp-v1.8.1) (2026-07-29)
 
 

package/dist/completion.js

@@ -1,6 +1,7 @@
 import { CompletionItem, CompletionItemKind, InsertTextFormat, MarkupKind } from "vscode-languageserver/node.js";
 import { getCompletions as getCoreCompletions } from "./completion-core.js";
 import { findImportInsertPosition, findDeclareNsInsertPosition, computeRelativePath } from "./namespace-diagnostics.js";
+import { offsetToPosition } from "./references.js";
 export function getCompletions(ctx, currentAnalysis, importedAnalyses, snippets, lastValidAnalysis, availableAnalyses, knownNamespaces, editContext) {
     return getCoreCompletions(ctx, currentAnalysis, importedAnalyses, snippets, lastValidAnalysis, availableAnalyses, knownNamespaces).map((e) => {
         const item = {
@@ -33,6 +34,19 @@ export function getCompletions(ctx, currentAnalysis, importedAnalyses, snippets,
                 newText = `declare namespace ${e.additionalEdit.prefix} = "${e.additionalEdit.namespaceUri}";\n`;
             }
             item.additionalTextEdits = [{ range: { start: insertPos, end: insertPos }, newText }];
+            // The "declare namespace" entry's own insertText is just an echo of what's already
+            // typed after the prefix (often ""). Some clients (e.g. eglot) fall back to inserting
+            // the item's label verbatim at the cursor when insertText is empty, which would dump
+            // the whole `declare namespace tei = "...";` statement inline. An explicit textEdit
+            // with a concrete range forces every spec-compliant client onto the deterministic
+            // replace path instead of guessing, so only the additionalTextEdit above lands the text.
+            if (e.additionalEdit.kind === "declare-namespace") {
+                const start = ctx.cursorOffset - e.insertText.length;
+                item.textEdit = {
+                    range: { start: offsetToPosition(docText, start), end: offsetToPosition(docText, ctx.cursorOffset) },
+                    newText: e.insertText,
+                };
+            }
         }
         return item;
     });

package/dist/runtimes/existdb/file.xq

@@ -116,6 +116,59 @@ declare function file:read-unicode($path as item()) as xs:string? external;
  :)
 declare function file:read-unicode($path as item(), $encoding as xs:string) as xs:string? external;
 
+(:~
+ : Writes the node set into a file on the file system. $parameters contains a
+ : sequence of zero or more serialization parameters specified as key=value
+ : pairs. The serialization options are the same as those recognized by
+ : "declare option exist:serialize". The function does NOT automatically
+ : inherit the serialization options of the XQuery it is called from. This
+ : method is only available to the DBA role.
+ : @param $node-set The contents to write to the file system.
+ : @param $path The full path or URI to the file
+ : @param $parameters The serialization parameters: either a sequence of key=value pairs or an output:serialization-parameters element as defined by the standard fn:serialize function.
+ : @return true on success - false if the specified file can not be created or is not writable. The empty sequence is returned if the argument sequence is empty.
+ :)
+declare function file:serialize($node-set as node()*, $path as item(), $parameters as item()*) as xs:boolean? external;
+
+(:~
+ : Writes the node set into a file on the file system, optionally appending to
+ : it. $parameters contains a sequence of zero or more serialization parameters
+ : specified as key=value pairs. The serialization options are the same as
+ : those recognized by "declare option exist:serialize". The function does NOT
+ : automatically inherit the serialization options of the XQuery it is called
+ : from. This method is only available to the DBA role.
+ : @param $node-set The contents to write to the file system.
+ : @param $path The full path or URI to the file
+ : @param $parameters The serialization parameters: either a sequence of key=value pairs or an output:serialization-parameters element as defined by the standard fn:serialize function.
+ : @param $append Should content be appended?
+ : @return true on success - false if the specified file can not be created or is not writable. The empty sequence is returned if the argument sequence is empty.
+ :)
+declare function file:serialize(
+	$node-set as node()*,
+	$path as item(),
+	$parameters as item()*,
+	$append as xs:boolean
+) as xs:boolean? external;
+
+(:~
+ : Writes binary data into a file on the file system. This method is only
+ : available to the DBA role.
+ : @param $binarydata The contents to write to the file system.
+ : @param $path The full path or URI to the file
+ : @return true on success - false if the specified file can not be created or is not writable
+ :)
+declare function file:serialize-binary($binarydata as xs:base64Binary, $path as item()) as xs:boolean external;
+
+(:~
+ : Writes binary data into a file on the file system, optionally appending the
+ : content. This method is only available to the DBA role.
+ : @param $binarydata The contents to write to the file system.
+ : @param $path The full path or URI to the file
+ : @param $append Should content be appended?
+ : @return true on success - false if the specified file can not be created or is not writable
+ :)
+declare function file:serialize-binary($binarydata as xs:base64Binary, $path as item(), $append as xs:boolean) as xs:boolean external;
+
 (:~
  : Synchronize a collection with a directory hierarchy. This method is only
  : available to the DBA role.

package/dist/runtimes/existdb/request.xq

@@ -240,3 +240,19 @@ declare function request:is-multipart-content() as xs:boolean external;
  : @param $value The attribute value
  :)
 declare function request:set-attribute($name as xs:string, $value as item()*) as empty-sequence() external;
+ : Returns the empty sequence if no item of $available is acceptable; the
+ : caller should then respond with 406 Not Acceptable.
+ : @param $available The media types the server can produce, in order of preference.
+ : @return the best matching media type, or the empty sequence if none is acceptable
+ :)
+declare function request:negotiate-content-type($available as xs:string*) as xs:string? external;
+
+(:~
+ : Returns $default if no item of $available is acceptable.
+ : @param $available The media types the server can produce, in order of preference.
+ : @param $default The media type to fall back to when no item of $available is acceptable.
+ : @return the best matching media type, or $default if none is acceptable
+ :)
+declare function request:negotiate-content-type($available as xs:string*, $default as xs:string?) as xs:string? external;
+
+(:~

package/dist/runtimes/existdb/response.xq

@@ -13,18 +13,54 @@ declare function response:redirect-to($uri as xs:anyURI) as empty-sequence() ext
 
 (:~
  : Sets a HTTP Cookie on the HTTP Response.
+ : @param $name The cookie name
+ : @param $value The cookie value
  :)
-declare function response:set-cookie() as empty-sequence() external;
+declare function response:set-cookie($name as xs:string, $value as xs:string) as empty-sequence() external;
+
+(:~
+ : Sets a HTTP Cookie on the HTTP Response.
+ : @param $name The cookie name
+ : @param $value The cookie value
+ : @param $max-age The xs:duration of the cookie
+ :)
+declare function response:set-cookie(
+	$name as xs:string,
+	$value as xs:string,
+	$max-age as xs:duration?,
+	$secure-flag as xs:boolean?
+) as empty-sequence() external;
+
+(:~
+ : Sets a HTTP Cookie on the HTTP Response.
+ : @param $name The cookie name
+ : @param $value The cookie value
+ : @param $max-age The xs:duration of the cookie
+ : @param $domain The cookie domain
+ : @param $path The cookie path
+ :)
+declare function response:set-cookie(
+	$name as xs:string,
+	$value as xs:string,
+	$max-age as xs:duration?,
+	$secure-flag as xs:boolean?,
+	$domain as xs:string?,
+	$path as xs:string?
+) as empty-sequence() external;
 
 (:~
  : Sets a HTTP Header on the HTTP Response.
+ : @param $name The header name
+ : @param $value The header value
  :)
-declare function response:set-date-header() as empty-sequence() external;
+declare function response:set-date-header($name as xs:string, $value as xs:string) as empty-sequence() external;
 
 (:~
  : Sets a HTTP Header on the HTTP Response.
+ : @param $name The header name
+ : @param $value The header value
  :)
-declare function response:set-header() as empty-sequence() external;
+declare function response:set-header($name as xs:string, $value as xs:string) as empty-sequence() external;
 
 (:~
  : Sets a HTTP server status code on the HTTP Response.
@@ -46,5 +82,22 @@ declare function response:stream($content as item()*, $serialization-options as
  : ContentType HTTP header is set to the value given in $content-type. Note:
  : the servlet output stream will be closed afterwards and mime-type settings
  : in the prolog will not be passed.
+ : @param $binary-data The binary data to stream
+ : @param $content-type The ContentType HTTP header value
+ : @param $filename The filename. If provided, a Content-Disposition header is set for the filename in the HTTP Response
+ :)
+declare function response:stream-binary($binary-data as xs:base64Binary, $content-type as xs:string, $filename as xs:string?) as empty-sequence() external;
+
+(:~
+ : @param $binary-resource-path The path to the stored binary resource, e.g. /db/path/to/image.png
+ : @param $content-type The ContentType HTTP header value
+ :)
+declare function response:stream-binary-resource($binary-resource-path as xs:string, $content-type as xs:string) as empty-sequence() external;
+
+(:~
+ : A Content-Disposition header is set from $filename.
+ : @param $binary-resource-path The path to the stored binary resource, e.g. /db/path/to/image.png
+ : @param $content-type The ContentType HTTP header value
+ : @param $filename The filename. If provided, a Content-Disposition header is set for the filename in the HTTP Response
  :)
-declare function response:stream-binary() as empty-sequence() external;
+declare function response:stream-binary-resource($binary-resource-path as xs:string, $content-type as xs:string, $filename as xs:string?) as empty-sequence() external;

package/dist/runtimes/existdb/scheduler.xq

@@ -33,3 +33,176 @@ declare function scheduler:pause-scheduled-job($job-name as xs:string) as xs:boo
  : @return the indicator of successful resumption
  :)
 declare function scheduler:resume-scheduled-job($job-name as xs:string) as xs:boolean external;
+
+(:~
+ : Schedules the Java Class named (the class must extend
+ : org.exist.scheduler.UserJavaJob) according to the Cron expression. The job
+ : will be registered using the job name.
+ : @param $java-classname The full name of the class to be executed. It must extend the org.exist.scheduler.UserJavaJob class.
+ : @param $cron-expression The cron expression. Please see the scheduler documentation.
+ : @param $job-name The name of the job.
+ :)
+declare function scheduler:schedule-java-cron-job($java-classname as xs:string, $cron-expression as xs:string, $job-name as xs:string) as item()* external;
+
+(:~
+ : Schedules the Java Class named (the class must extend
+ : org.exist.scheduler.UserJavaJob) according to the Cron expression. The job
+ : will be registered using the name passed in $job-name. The final argument
+ : can be used to specify parameters for the job, which will be passed to the
+ : query as external variables. Parameters are specified in an XML fragment
+ : with the following structure: <parameters><param name="param-name1"
+ : value="param-value1"/></parameters>.
+ : @param $java-classname The full name of the class to be executed. It must extend the org.exist.scheduler.UserJavaJob class.
+ : @param $cron-expression The cron expression. Please see the scheduler documentation.
+ : @param $job-name The name of the job.
+ : @param $job-parameters The XML fragment with the following structure: <parameters><param name="param-name1" value="param-value1"/></parameters>
+ :)
+declare function scheduler:schedule-java-cron-job(
+	$java-classname as xs:string,
+	$cron-expression as xs:string,
+	$job-name as xs:string,
+	$job-parameters as element()?
+) as item()* external;
+
+(:~
+ : Schedules the Java Class named (the class must extend
+ : org.exist.scheduler.UserJavaJob) according to the periodic value. The job
+ : will be registered using the job name. The $job-parameters argument can be
+ : used to specify parameters for the job, which will be passed to the query as
+ : external variables. Parameters are specified in an XML fragment with the
+ : following structure: <parameters><param name="param-name1"
+ : value="param-value1"/></parameters>, Given the delay and the repeat.
+ : @param $java-classname The full name of the class to be executed. It must extend the org.exist.scheduler.UserJavaJob class.
+ : @param $period Time in milliseconds between execution of the job
+ : @param $job-name The name of the job.
+ : @param $job-parameters The XML fragment with the following structure: <parameters><param name="param-name1" value="param-value1"/></parameters>
+ : @param $delay The period in milliseconds to delay the start of a job.
+ : @param $repeat The number of times to repeat the job after the initial execution. A value of -1 means repeat forever.
+ :)
+declare function scheduler:schedule-java-periodic-job(
+	$java-classname as xs:string,
+	$period as xs:integer,
+	$job-name as xs:string,
+	$job-parameters as element()?,
+	$delay as xs:integer,
+	$repeat as xs:integer
+) as item()* external;
+
+(:~
+ : Schedules the named XQuery resource (e.g. /db/foo.xql) according to the Cron
+ : expression. XQuery job's will be launched under the guest account initially,
+ : although the running XQuery may switch permissions through calls to
+ : xmldb:login(). The job will be registered using the job name. Jobs submitted
+ : via this function are transitory and will be lost on a server restart. To
+ : ensure the persistence of scheduled tasks add them to the conf.xml file.
+ : @param $xquery-resource The path to the XQuery resource
+ : @param $cron-expression The cron expression. Please see the scheduler documentation.
+ : @param $job-name The name of the job.
+ :)
+declare function scheduler:schedule-xquery-cron-job($xquery-resource as xs:string, $cron-expression as xs:string, $job-name as xs:string) as item()* external;
+
+(:~
+ : Schedules the named XQuery resource (e.g. /db/foo.xql) according to the Cron
+ : expression. XQuery job's will be launched under the guest account initially,
+ : although the running XQuery may switch permissions through calls to
+ : xmldb:login(). The job will be registered using the job name. The final
+ : argument can be used to specify parameters for the job, which will be passed
+ : to the query as external variables. Parameters are specified in an XML
+ : fragment with the following structure: <parameters><param name="param-name1"
+ : value="param-value1"/></parameters> Jobs submitted via this function are
+ : transitory and will be lost on a server restart. To ensure the persistence
+ : of scheduled tasks add them to the conf.xml file.
+ : @param $xquery-resource The path to the XQuery resource
+ : @param $cron-expression A cron expression. Please see the scheduler documentation.
+ : @param $job-name The name of the job.
+ : @param $job-parameters XML fragment with the following structure: <parameters><param name="param-name1" value="param-value1"/></parameters>
+ :)
+declare function scheduler:schedule-xquery-cron-job(
+	$xquery-resource as xs:string,
+	$cron-expression as xs:string,
+	$job-name as xs:string,
+	$job-parameters as element()?
+) as item()* external;
+
+(:~
+ : Schedules the named XQuery resource (e.g. /db/foo.xql) according to the Cron
+ : expression. XQuery job's will be launched under the guest account initially,
+ : although the running XQuery may switch permissions through calls to
+ : xmldb:login(). The job will be registered using the job name. The job
+ : parameters argument can be used to specify parameters for the job, which
+ : will be passed to the query as external variables. Parameters are specified
+ : in an XML fragment with the following structure: <parameters><param
+ : name="param-name1" value="param-value1"/></parameters> Jobs submitted via
+ : this function are transitory and will be lost on a server restart. To ensure
+ : the persistence of scheduled tasks add them to the conf.xml file.
+ : @param $xquery-resource The path to the XQuery resource
+ : @param $cron-expression A cron expression. Please see the scheduler documentation.
+ : @param $job-name The name of the job.
+ : @param $job-parameters XML fragment with the following structure: <parameters><param name="param-name1" value="param-value1"/></parameters>
+ : @param $unschedule Specifies whether to unschedule this job if an XPathException is raised, default is true.
+ :)
+declare function scheduler:schedule-xquery-cron-job(
+	$xquery-resource as xs:string,
+	$cron-expression as xs:string,
+	$job-name as xs:string,
+	$job-parameters as element()?,
+	$unschedule as xs:boolean
+) as item()* external;
+
+(:~
+ : Schedules the named XQuery resource (e.g. /db/foo.xql) according to the
+ : period. XQuery job's will be launched under the guest account initially,
+ : although the running XQuery may switch permissions through calls to
+ : xmldb:login(). The job will be registered using the job name. The job
+ : parameters argument can be used to specify parameters for the job, which
+ : will be passed to the query as external variables. Parameters are specified
+ : in an XML fragment with the following structure: <parameters><param
+ : name="param-name1" value="param-value1"/></parameters> , Given the delay
+ : passed and the repeat value. Jobs submitted via this function are transitory
+ : and will be lost on a server restart. To ensure the persistence of scheduled
+ : tasks add them to the conf.xml file.
+ : @param $xquery-resource The path to the XQuery resource
+ : @param $period Time in milliseconds between execution of the job
+ : @param $job-name The name of the job.
+ : @param $job-parameters XML fragment with the following structure: <parameters><param name="param-name1" value="param-value1"/></parameters>
+ : @param $delay Can be used with a period in milliseconds to delay the start of a job.
+ : @param $repeat Number of times to repeat the job after the initial execution. A value of -1 means repeat forever.
+ :)
+declare function scheduler:schedule-xquery-periodic-job(
+	$xquery-resource as xs:string,
+	$period as xs:integer,
+	$job-name as xs:string,
+	$job-parameters as element()?,
+	$delay as xs:integer,
+	$repeat as xs:integer
+) as item()* external;
+
+(:~
+ : Schedules the named XQuery resource (e.g. /db/foo.xql) according to the
+ : period. XQuery job's will be launched under the guest account initially,
+ : although the running XQuery may switch permissions through calls to
+ : xmldb:login(). The job will be registered using the job name. The job
+ : parameters argument can be used to specify parameters for the job, which
+ : will be passed to the query as external variables. Parameters are specified
+ : in an XML fragment with the following structure: <parameters><param
+ : name="param-name1" value="param-value1"/></parameters> , Given the delay
+ : passed and the repeat value. Jobs submitted via this function are transitory
+ : and will be lost on a server restart. To ensure the persistence of scheduled
+ : tasks add them to the conf.xml file.
+ : @param $xquery-resource The path to the XQuery resource
+ : @param $period Time in milliseconds between execution of the job
+ : @param $job-name The name of the job.
+ : @param $job-parameters XML fragment with the following structure: <parameters><param name="param-name1" value="param-value1"/></parameters>
+ : @param $delay Can be used with a period in milliseconds to delay the start of a job.
+ : @param $repeat Number of times to repeat the job after the initial execution. A value of -1 means repeat forever.
+ : @param $unschedule Specifies whether to unschedule this job if an XPathException is raised, default is true.
+ :)
+declare function scheduler:schedule-xquery-periodic-job(
+	$xquery-resource as xs:string,
+	$period as xs:integer,
+	$job-name as xs:string,
+	$job-parameters as element()?,
+	$delay as xs:integer,
+	$repeat as xs:integer,
+	$unschedule as xs:boolean
+) as item()* external;

package/dist/runtimes/existdb/system.xq

@@ -57,15 +57,21 @@ declare function system:enable-tracing($enable as xs:boolean) as empty-sequence(
 declare function system:enable-tracing($enable as xs:boolean, $tracelog as xs:boolean) as empty-sequence() external;
 
 (:~
+ : @param $dir This is an absolute path to where the backup will be written. Must be writeable by the eXist process.
+ : @param $incremental Flag to do incremental export.
+ : @param $zip Flag to do export to zip file.
  : @return the export results
  :)
-declare function system:export() as node() external;
+declare function system:export($dir as xs:string, $incremental as xs:boolean?, $zip as xs:boolean?) as node() external;
 
 (:~
  : Messagers from exporter reroute to logs.
+ : @param $dir This is an absolute path to where the backup will be written. Must be writeable by the eXist process.
+ : @param $incremental Flag to do incremental export.
+ : @param $zip Flag to do export to zip file.
  : @return the export results
  :)
-declare function system:export-silently() as xs:boolean external;
+declare function system:export-silently($dir as xs:string, $incremental as xs:boolean?, $zip as xs:boolean?) as xs:boolean external;
 
 (:~
  : A pseudo-function to execute a function as a different user. The first
@@ -187,17 +193,29 @@ declare function system:get-uptime() as xs:dayTimeDuration external;
  :)
 declare function system:get-version() as xs:string external;
 
-declare function system:import() as item()* external;
+(:~
+ : @param $admin-pass The password for the admin user
+ : @param $new-admin-pass Set the admin password to this new password.
+ :)
+declare function system:import($dir-or-file as xs:string, $admin-pass as xs:string?, $new-admin-pass as xs:string?) as item()* external;
 
 (:~
  : Messagers from exporter reroute to logs.
+ : @param $admin-pass The password for the admin user
+ : @param $new-admin-pass Set the admin password to this new password.
+ :)
+declare function system:import-silently($dir-or-file as xs:string, $admin-pass as xs:string?, $new-admin-pass as xs:string?) as item()* external;
+
+(:~
+ : Kill a running XQuey (dba role only).
  :)
-declare function system:import-silently() as item()* external;
+declare function system:kill-running-xquery($xquery-id as xs:integer) as empty-sequence() external;
 
 (:~
  : Kill a running XQuey (dba role only).
+ : @param $wait-time The wait time in milliseconds before terminating the XQuery
  :)
-declare function system:kill-running-xquery() as empty-sequence() external;
+declare function system:kill-running-xquery($xquery-id as xs:integer, $wait-time as xs:long) as empty-sequence() external;
 
 (:~
  : Restore the database or a section of the database (admin user only).

package/dist/runtimes/existdb/util.xq

@@ -14,8 +14,10 @@ declare function util:absolute-resource-id($node-or-path as item()) as xs:intege
 
 (:~
  : Converts the number $number from base $base to xs:integer.
+ : @param $number The number to convert
+ : @param $base The base of $number
  :)
-declare function util:base-to-integer() as item()* external;
+declare function util:base-to-integer($number as item(), $base as xs:integer) as item()* external;
 
 (:~
  : Decode the given Base64 encoded string back to clear text
@@ -409,8 +411,10 @@ declare function util:expand($node as node()*, $serialization-parameters as xs:s
  : name and arity, an error is thrown. Please note: the arguments to this
  : function have to be literals or need to be resolvable at compile time at
  : least.
+ : @param $name The name of the function
+ : @param $arity The arity of the function
  :)
-declare function util:function() as item()* external;
+declare function util:function($name as xs:QName, $arity as xs:integer) as item()* external;
 
 (:~
  : Serializes an XML fragment or a sequence of nodes between two elements
@@ -442,9 +446,10 @@ declare function util:get-fragment-between(
 (:~
  : Returns a short description of the module identified by the namespace URI.
  : @deprecated Use inspect:inspect-module-uri#1 instead!
+ : @param $namespace-uri The namespace URI of the module
  : @return the description of the active function module identified by the namespace URI
  :)
-declare function util:get-module-description() as xs:string+ external;
+declare function util:get-module-description($namespace-uri as xs:string) as xs:string+ external;
 
 (:~
  : Returns an XML fragment providing additional information about the module
@@ -453,6 +458,15 @@ declare function util:get-module-description() as xs:string+ external;
  :)
 declare function util:get-module-info() as element() external;
 
+(:~
+ : Returns an XML fragment providing additional information about the module
+ : identified by the namespace URI.
+ : @deprecated Use inspect:inspect-module-uri#1 instead!
+ : @param $namespace-uri The namespace URI of the module
+ : @return the description of the active function module identified by the namespace URI
+ :)
+declare function util:get-module-info($namespace-uri as xs:string) as element() external;
+
 (:~
  : Gets the value of a serialization option as set with 'declare option'.
  : @param $name The serialization option name
@@ -478,8 +492,18 @@ declare function util:get-sequence-type($sequence-type as xs:anyType*) as xs:str
 
 (:~
  : Calculates a hashcode from a string based on a specified algorithm.
+ : @param $message The string to generate the hashcode from
+ : @param $algorithm The algorithm used to generate the hashcode
+ :)
+declare function util:hash($message as item(), $algorithm as xs:string) as item()* external;
+
+(:~
+ : Calculates a hashcode from a string based on a specified algorithm.
+ : @param $message The string to generate the hashcode from
+ : @param $algorithm The algorithm used to generate the hashcode
+ : @param $base64flag The flag that specifies whether to return the result as Base64 encoded
  :)
-declare function util:hash() as item()* external;
+declare function util:hash($message as item(), $algorithm as xs:string, $base64flag as xs:boolean) as item()* external;
 
 (:~
  : Dynamically imports an XQuery module into the current context. The
@@ -498,13 +522,33 @@ declare function util:import-module(
 
 (:~
  : Return the number of documents for an indexed value.
+ : @param $nodes The nodes whose content is indexed
+ : @param $value The indexed value to search for
  :)
-declare function util:index-key-documents() as item()* external;
+declare function util:index-key-documents($nodes as node()*, $value as xs:anyAtomicType) as item()* external;
+
+(:~
+ : Return the number of documents for an indexed value.
+ : @param $nodes The nodes whose content is indexed
+ : @param $value The indexed value to search for
+ : @param $index The index in which the search is made
+ :)
+declare function util:index-key-documents($nodes as node()*, $value as xs:anyAtomicType, $index as xs:string) as item()* external;
 
 (:~
  : Return the number of occurrences for an indexed value.
+ : @param $nodes The nodes whose content is indexed
+ : @param $value The indexed value to search for
+ :)
+declare function util:index-key-occurrences($nodes as node()*, $value as xs:anyAtomicType) as item()* external;
+
+(:~
+ : Return the number of occurrences for an indexed value.
+ : @param $nodes The nodes whose content is indexed
+ : @param $value The indexed value to search for
+ : @param $index The index in which the search is made
  :)
-declare function util:index-key-occurrences() as item()* external;
+declare function util:index-key-occurrences($nodes as node()*, $value as xs:anyAtomicType, $index as xs:string) as item()* external;
 
 (:~
  : Can be used to query existing range indexes defined on a set of nodes. All
@@ -589,8 +633,10 @@ declare function util:int-to-octal($int as xs:int) as xs:string external;
 (:~
  : Converts the xs:integer $number (unsigned) into base $base as xs:string.
  : Bases 2, 8, and 16 are supported.
+ : @param $number The number to convert
+ : @param $base The base of $number
  :)
-declare function util:integer-to-base() as item()* external;
+declare function util:integer-to-base($number as xs:integer, $base as xs:integer) as item()* external;
 
 (:~
  : Checks if the resource identified by $binary-resource is a binary resource.
@@ -602,16 +648,18 @@ declare function util:is-binary-doc($binary-resource as xs:string?) as xs:boolea
 (:~
  : Returns a Boolean value if the module statically mapped to a source location
  : in the configuration file.
+ : @param $namespace-uri The namespace URI of the module
  : @return true if the namespace URI is mapped as an active function module
  :)
-declare function util:is-module-mapped() as xs:boolean external;
+declare function util:is-module-mapped($namespace-uri as xs:string) as xs:boolean external;
 
 (:~
  : Returns a Boolean value if the module identified by the namespace URI is
  : registered.
+ : @param $namespace-uri The namespace URI of the module
  : @return true if the namespace URI is registered as an active function module
  :)
-declare function util:is-module-registered() as xs:boolean external;
+declare function util:is-module-registered($namespace-uri as xs:string) as xs:boolean external;
 
 (:~
  : Retrieves the line number of the expression
@@ -668,12 +716,41 @@ declare function util:list-functions() as function(*)* external;
  :)
 declare function util:list-functions($namespace-uri as xs:string) as function(*)* external;
 
+(:~
+ : Logs the message to the current logger.
+ : @param $priority The logging priority: 'error', 'warn', 'debug', 'info', 'trace'
+ : @param $message The message to log
+ :)
+declare function util:log($priority as xs:string, $message as item()*) as empty-sequence() external;
+
+(:~
+ : Logs the message to the named logger
+ : @param $priority The logging priority: 'error', 'warn', 'debug', 'info', 'trace'
+ : @param $logger-name The name of the logger, eg: my.app.log
+ : @param $message The message to log
+ :)
+declare function util:log-app($priority as xs:string, $logger-name as xs:string, $message as item()*) as empty-sequence() external;
+
+(:~
+ : Logs the message to System.err.
+ : @param $message The message to log
+ :)
+declare function util:log-system-err($message as item()*) as empty-sequence() external;
+
+(:~
+ : Logs the message to System.out.
+ : @param $message The message to log
+ :)
+declare function util:log-system-out($message as item()*) as empty-sequence() external;
+
 (:~
  : Map the module to a source location. This function is only available to the
  : DBA role.
+ : @param $namespace-uri The namespace URI of the module
+ : @param $location-uri The location URI of the module
  : @return Returns an empty sequence
  :)
-declare function util:map-module() as empty-sequence() external;
+declare function util:map-module($namespace-uri as xs:string, $location-uri as xs:string) as empty-sequence() external;
 
 (:~
  : Returns a sequence containing the namespace URIs of all XQuery modules which
@@ -722,8 +799,9 @@ declare function util:octal-to-int($octal as xs:string) as xs:int external;
  : be well-formed XML. It will be passed through the Neko HTML parser to make
  : it well-formed. An empty sequence is returned if the argument is an empty
  : string or sequence.
+ : @param $to-be-parsed The string to be parsed
  :)
-declare function util:parse-html() as item()* external;
+declare function util:parse-html($to-be-parsed as xs:string?) as item()* external;
 
 (:~
  : Can be used to query existing qname indexes defined on a set of nodes.
@@ -865,9 +943,10 @@ declare function util:unescape-uri($escaped-string as xs:string, $encoding as xs
 (:~
  : Remove relation between module namespace and source location. This function
  : is only available to the DBA role.
+ : @param $namespace-uri The namespace URI of the module
  : @return Returns an empty sequence
  :)
-declare function util:unmap-module() as empty-sequence() external;
+declare function util:unmap-module($namespace-uri as xs:string) as empty-sequence() external;
 
 (:~
  : Generate a version 4 (random) universally unique identifier (UUID) string,

package/dist/runtimes/existdb/xmldb.xq

@@ -285,8 +285,19 @@ declare function xmldb:match-collection($regexp as xs:string) as xs:string* exte
 (:~
  : Moves the collection $source-collection-uri into the collection
  : $target-collection-uri.
+ : @param $source-collection-uri The source collection URI
+ : @param $target-collection-uri The target collection URI
+ :)
+declare function xmldb:move($source-collection-uri as xs:string, $target-collection-uri as xs:string) as empty-sequence() external;
+
+(:~
+ : Moves the resource $resource from the collection $source-collection-uri into
+ : collection $target-collection-uri.
+ : @param $source-collection-uri The source collection URI
+ : @param $target-collection-uri The target collection URI
+ : @param $resource The resource
  :)
-declare function xmldb:move() as empty-sequence() external;
+declare function xmldb:move($source-collection-uri as xs:string, $target-collection-uri as xs:string, $resource as xs:string) as empty-sequence() external;
 
 (:~
  : Registers an XMLDB driver class with the XMLDB Database Manager. This is