@sitevision/api 2025.7.1 → 2025.9.2

package/common/router/index.d.ts

@@ -22,7 +22,7 @@ export interface Request {
   updateSession(): Session;
   header(headerName: string): string | null;
   file(fileParameterName: string): Node;
-  params: { [key: string]: string };
+  params: { [key: string]: string | string[] };
   cookies: { [key: string]: string };
   xhr: boolean;
   serverside: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sitevision/api",
-  "version": "2025.7.1",
+  "version": "2025.9.2",
   "author": "Sitevision AB",
   "license": "MIT",
   "type": "module",
@@ -30,5 +30,5 @@
     "access": "public",
     "directory": "dist"
   },
-  "gitHead": "771eb380b026a8b6df85ac5c55a83dfa55b9a179"
+  "gitHead": "8982238e5bcb02d044c9fce2addb01a225972f2c"
 }

package/server/ImageUtil/index.d.ts

@@ -302,6 +302,24 @@ export interface ImageUtil {
    * @since Sitevision 2024.07.1
    */
   setCaptionText(aImage: Node, aCaptionText: String | string): void;
+
+  /**
+   * Sets the source property for an image Node.
+   *
+   *  <p>
+   *     <strong>Permission note!</strong> Current user (the invoker of this method) must have
+   *     {@link senselogic.sitevision.api.security.PermissionUtil.Permission#WRITE WRITE} permission
+   *     on the image node that should be updated. <em>Updating an image for a <code>sv:userIdentity</code> requires
+   *     {@link senselogic.sitevision.api.security.PermissionUtil.Permission#MANAGE_USER_IDENTITIES MANAGE_USER_IDENTITIES} permission
+   *     on current page.</em>
+   *  </p>
+   * @param aImage the sv:image Node, may not be null
+   * @param aSourceText the source text to set
+   * @throws ConstraintViolationException if aImage is not a sv:image or if current user is not authorized to alter the image node
+   * @throws RepositoryException if something else goes wrong
+   * @since Sitevision 2025.07.1
+   */
+  setSourceText(aImage: Node, aSourceText: String | string): void;
 }
 
 declare namespace ImageUtil {}

package/server/ImageUtil/index.js

@@ -15,5 +15,6 @@ var _default = exports["default"] = {
   renameImage: function renameImage() {},
   toBase64: function toBase64() {},
   setAltText: function setAltText() {},
-  setCaptionText: function setCaptionText() {}
+  setCaptionText: function setCaptionText() {},
+  setSourceText: function setSourceText() {}
 };

package/server/OutputUtil/index.d.ts

@@ -361,10 +361,8 @@ export interface OutputUtil extends OutputUtilConstants {
    * Convenience method for rendering a linked web path to a specified node.
    *
    *  <p>
-   *  --------------------------------------------------------- <br>
-   *  <strong>Example:</strong> You use Velocity and want to do a simple "path to this page" menu
-   *  with a pretty "double arrow" between the links<br>
-   *  ---------------------------------------------------------
+   *  <strong>Example:</strong> You use Velocity and want to do a simple "path to this page" trail using the
+   *  <a href="https://envisionui.io/components/breadcrumb/" target="_blank">Envision Breadcrumb Component</a> markup.
    *  </p>
    *
    *  <p><strong>A) The explicit way:</strong></p>
@@ -382,15 +380,20 @@ export interface OutputUtil extends OutputUtilConstants {
    *        #set ($linkRenderer = $sitevisionUtils.getLinkRenderer())
    *
    *        <em>## Render links to all nodes</em>
-   *        &lt;p class="normal"&gt;
-   *        #foreach ($node in $pathList)
-   *           $linkRenderer.update($node)
-   *           #if ($velocityCount &gt; 0)
-   *              &amp;raquo;
-   *           #end
-   *           $linkRenderer.render()
-   *        #end
-   *        &lt;/p&gt;
+   *        &lt;nav class="normal"&gt;
+   *             <em>## Use a list for accessibility (https://envisionui.io/components/breadcrumb/)</em>
+   *             &lt;ol class="env-breadcrumb"&gt;
+   *              #foreach ($node in $pathList)
+   *                 $linkRenderer.update($node)
+   *                 &lt;li class="env-breadcrumb__item"&gt;
+   *                    $linkRenderer.render()
+   *                    #if (!$foreach.last)
+   *                       &lt;span aria-hidden=true class="env-breadcrumb__separator"&gt;&amp;raquo;&lt;/span&gt;
+   *                    #end
+   *                 &lt;/li&gt;
+   *              #end
+   *           &lt;/ol&gt;
+   *        &lt;/nav&gt;
    *     #end</code></pre>
    *
    *  <p><strong>B) The convenient way:</strong></p>
@@ -403,7 +406,7 @@ export interface OutputUtil extends OutputUtilConstants {
    *     <em>## Render</em>
    *     #set ($result = $outputUtil.renderWebPathNodes($currentPage, $linkRenderer, ' &amp;raquo; '))
    *     #if ($result != '')
-   *        &lt;p class="normal"&gt;$result&lt;/p&gt;
+   *        &lt;nav aria-label="Breadcrumb" class="normal"&gt;$result&lt;/nav&gt;
    *     #end</code></pre>
    *
    *  <p>
@@ -412,7 +415,7 @@ export interface OutputUtil extends OutputUtilConstants {
    * @param aDescendantNode the node the web path should be rendered for
    * @param aLinkRenderer the link renderer that determines how links are rendered
    * @param aSeparator the separator that should be put between the links. <em>Note! This is not encoded by this method.</em>
-   * @return a linked web path, or empty string if aDescendantNode is <code>null</code>, <code>aLinkRenderer</code> is <code>null</code>,&#xA; <code>aSeparator</code> is <code>null</code> or no web path could be created.
+   * @return a HTML list of linked web paths, or empty string if aDescendantNode is <code>null</code>,&#xA; <code>aLinkRenderer</code> is <code>null</code> or no web path could be created.
    * @see senselogic.sitevision.api.node.NodeTreeUtil#getWebPathNodes(javax.jcr.Node)
    * @since Sitevision 3.0.2
    */

package/server/PermissionUtil.Permission/index.d.ts

@@ -55,6 +55,7 @@ declare enum Permission {
   MANAGE_CUSTOM_SEARCH_INDEX,
   MANAGE_PUBLISHING_LOCK,
   MANAGE_DASHBOARDS,
+  MANAGE_AI,
 }
 
 export default Permission;

package/server/PermissionUtil.Permission/index.js

@@ -39,5 +39,6 @@ var _default = exports["default"] = {
   MANAGE_TYPES_IDENTIFIERS: "MANAGE_TYPES_IDENTIFIERS",
   MANAGE_CUSTOM_SEARCH_INDEX: "MANAGE_CUSTOM_SEARCH_INDEX",
   MANAGE_PUBLISHING_LOCK: "MANAGE_PUBLISHING_LOCK",
-  MANAGE_DASHBOARDS: "MANAGE_DASHBOARDS"
+  MANAGE_DASHBOARDS: "MANAGE_DASHBOARDS",
+  MANAGE_AI: "MANAGE_AI"
 };

package/server/storage/index.d.ts

@@ -14,7 +14,7 @@ export interface CollectionDataStore {
   addAll(data: any[]): void;
   get(dsid: string): unknown;
   set(dsid: string, data: any): void;
-  remove(dsid: string): void;
+  remove(dsid: string): unknown;
   removeAll(): void;
 
   find(query: string, options?: FindOptions): SearchResult;

package/types/senselogic/sitevision/api/render/TextModuleRenderer/index.d.ts

@@ -250,8 +250,8 @@ export type TextModuleRenderer = {
    * Renders Markdown for the loaded Text module.
    *
    *  <p>
-   *  <strong>Note!</strong> The returned value will always be empty string if the {@link #isLoaded()} state is <code>false</code>
-   *  when invoking this render method <em>(i.e. you would typically always check the loaded state before calling this method).</em>
+   *     <strong>Note!</strong> The returned value will always be empty string if the {@link #isLoaded()} state is <code>false</code>
+   *     when invoking this render method <em>(i.e. you would typically always check the loaded state before calling this method).</em>
    *  </p>
    * @return the Markdown representation of the loaded Text module, or empty String if rendering fails or no Text module is loaded
    * @since Sitevision 2025.07.1