@sitevision/api 2025.11.1 → 2026.1.1

package/index.d.ts

@@ -19,7 +19,10 @@ import './server/ColorUtil';
 import './server/CompoundAndFilterBuilder';
 import './server/CompoundComparatorBuilder';
 import './server/CompoundOrFilterBuilder';
+import './server/ContentFormat';
 import './server/ContentNodeUtil';
+import './server/ContentRendererBuilder';
+import './server/CreateContentFactory';
 import './server/CurrencyFactory';
 import './server/DateUtil';
 import './server/DecorationUtil';
@@ -90,6 +93,7 @@ import './server/PublishingUtil';
 import './server/QueryStringUtil';
 import './server/RedirectUtil';
 import './server/RelatedValueBuilder';
+import './server/RendererBuilderFactory';
 import './server/Requester';
 import './server/ResourceLocatorUtil';
 import './server/RestApi';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sitevision/api",
-  "version": "2025.11.1",
+  "version": "2026.1.1",
   "author": "Sitevision AB",
   "license": "MIT",
   "type": "module",
@@ -30,5 +30,5 @@
     "access": "public",
     "directory": "dist"
   },
-  "gitHead": "197b8117f3063b9725e9c0329d24e3e9fb6172af"
+  "gitHead": "52e580c21b77cedc38ef73fbec05ded93d37dd6c"
 }

package/server/ContentFormat/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * This file is auto generated from JavaDoc. Do not modify it manually.
+ */
+
+/**
+ * Content format types for text modules.
+ *
+ *  <p>
+ *  This enum defines the supported content formats that can be used when creating or updating
+ *  text modules. The format determines how the raw content string is parsed and converted into
+ *  rich text elements.
+ *  </p>
+ * @author Jens Kalshoven
+ * @since Sitevision 2026.01.1
+ */
+declare enum ContentFormat {
+  MARKDOWN,
+}
+
+export default ContentFormat;

package/server/ContentFormat/index.js

@@ -0,0 +1,12 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+/**
+ * This file is auto generated. Do not modify it manually.
+ */
+var _default = exports["default"] = {
+  MARKDOWN: "MARKDOWN"
+};

package/server/ContentRendererBuilder/index.d.ts

@@ -0,0 +1,93 @@
+/**
+ * This file is auto generated from JavaDoc. Do not modify it manually.
+ */
+import type { Node } from "../../types/javax/jcr/Node";
+import type { Map } from "../../types/java/util/Map";
+import type { ContentRenderer } from "../../types/senselogic/sitevision/api/render/ContentRenderer";
+import type { Builder } from "../../types/senselogic/sitevision/api/base/Builder";
+
+/**
+ * <p>
+ *     Builder for creating a {@link ContentRenderer} instance.
+ *  </p>
+ *
+ *  <p>
+ *     ContentRendererBuilder has one <strong>mandatory attribute</strong> and one <em>optional</em> attribute:
+ *  </p>
+ *  <ul>
+ *     <li>
+ *        <em>page</em> (mandatory) - The page (sv:page, sv:article, sv:sitePage) where the content nodes to render resides.
+ *        Must not be null and must not be "current page".
+ *     </li>
+ *     <li>
+ *        <em>parameters</em> (optional) - A key/value map of page parameters to use when rendering the content nodes. May be null or empty.
+ *     </li>
+ *  </ul>
+ *
+ *  <p>
+ *     Using the ContentRendererBuilder is pretty straightforward, if you remember that it is <strong>stateful</strong>. Conceptually you
+ *     would typically use it like this:
+ *  </p>
+ *  <ol>
+ *    <li>Get the ContentRendererBuilder</li>
+ *    <li>Set the page</li>
+ *    <li>Potentially set the page parameters</li>
+ *    <li>Do build</li>
+ *  </ol>
+ *  <p>
+ *     When you have built a <code>ContentRenderer</code> instance, you can re-use the ContentRendererBuilder to build more instances.
+ *     Typically like:
+ *  </p>
+ *  <ol>
+ *    <li>Set the page</li>
+ *    <li>Potentially set the page parameters</li>
+ *    <li>Do build</li>
+ *  </ol>
+ *
+ *  <p>
+ *     <strong>Tip!</strong> The {@link senselogic.sitevision.api.base.Builder Builder interface documentation} contains
+ *     more information about Builders and how to work with them and {@link TextModuleRenderer} has a code example of how
+ *     this builder and its result can be used.
+ *  </p>
+ *
+ *  <p>
+ *     An instance of the Sitevision class implementing this interface can be obtained via
+ *     {@link RendererBuilderFactory#getContentRendererBuilder()}.
+ *     See {@link RendererBuilderFactory} for how to obtain an instance of the <code>RendererBuilderFactory</code> interface.
+ *  </p>
+ * @author Magnus Lövgren
+ * @since Sitevision 2026.01.1
+ */
+export interface ContentRendererBuilder extends Builder {
+  /**
+   * Sets the page of this builder.
+   *
+   *  <p>
+   *     <strong>Note! Due to security reasons (potential never-ending loops) it is prohibited to create a content renderer for
+   *     the currently executing page (i.e. {@link senselogic.sitevision.api.context.PortletContextUtil#getCurrentPage()})!</strong>
+   *  </p>
+   * @param aPageNode a page node (sv:page, sv:article, sv:sitePage) where current user has READ permission, must not be null or "current page".
+   * @return this builder
+   */
+  setPage(aPageNode: Node): ContentRendererBuilder;
+
+  /**
+   * Sets parameters for the page, to be used when rendering content.
+   * @param aParameters a map of parameters
+   * @return this builder
+   */
+  setParameters(aParameters: Map | {}): ContentRendererBuilder;
+
+  /**
+   * Creates a ContentRenderer instance for the page of this builder.
+   * @return a content renderer instance
+   * @throws IllegalStateException if no page is set or if page is invalid (e.g. "current page")
+   */
+  build(): ContentRenderer;
+}
+
+declare namespace ContentRendererBuilder {}
+
+declare var contentRendererBuilder: ContentRendererBuilder;
+
+export default contentRendererBuilder;

package/server/ContentRendererBuilder/index.js

@@ -0,0 +1,14 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+/**
+ * This file is auto generated. Do not modify it manually.
+ */
+var _default = exports["default"] = {
+  setPage: function setPage() {},
+  setParameters: function setParameters() {},
+  build: function build() {}
+};

package/server/CreateContentFactory/index.d.ts

@@ -0,0 +1,53 @@
+/**
+ * This file is auto generated from JavaDoc. Do not modify it manually.
+ */
+import type { TextModuleCreator } from "../../types/senselogic/sitevision/api/webresource/webcontent/TextModuleCreator";
+import type { TextModuleUpdater } from "../../types/senselogic/sitevision/api/webresource/webcontent/TextModuleUpdater";
+
+/**
+ * Factory for creating and updating web content in Sitevision.
+ *
+ *  <p>
+ *  This factory provides builder instances for creating and updating content.
+ *  </p>
+ *
+ *  <p>
+ *  An instance of the Sitevision class implementing this interface can be obtained via
+ *  {@link senselogic.sitevision.api.Utils#getCreateContentFactory()}.
+ *  See {@link senselogic.sitevision.api.Utils} for how to obtain an instance of the
+ *  <code>Utils</code> interface.
+ *  </p>
+ * @author Jens Kalshoven
+ * @since Sitevision 2026.01.1
+ */
+export interface CreateContentFactory {
+  /**
+   * Gets a builder for creating new text modules.
+   *
+   *  <p>
+   *  The returned builder can be used to configure and create a new text module (text portlet)
+   *  on a page or within a layout. Each call to this method returns a fresh builder instance
+   *  with no state carried over from previous operations.
+   *  </p>
+   * @return a new TextModuleCreator builder instance
+   */
+  getTextModuleCreator(): TextModuleCreator;
+
+  /**
+   * Gets a builder for updating existing text modules.
+   *
+   *  <p>
+   *  The returned builder can be used to update the content of an existing text module (text portlet).
+   *  Each call to this method returns a fresh builder instance with no state carried over from
+   *  previous operations.
+   *  </p>
+   * @return a new TextModuleUpdater builder instance
+   */
+  getTextModuleUpdater(): TextModuleUpdater;
+}
+
+declare namespace CreateContentFactory {}
+
+declare var createContentFactory: CreateContentFactory;
+
+export default createContentFactory;

package/server/CreateContentFactory/index.js

@@ -0,0 +1,13 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+/**
+ * This file is auto generated. Do not modify it manually.
+ */
+var _default = exports["default"] = {
+  getTextModuleCreator: function getTextModuleCreator() {},
+  getTextModuleUpdater: function getTextModuleUpdater() {}
+};

package/server/FileUtil/index.d.ts

@@ -132,26 +132,24 @@ export interface FileUtil {
   createFileFromTemporary(aParent: Node, aTemporaryFile: Node): Node;
 
   /**
-  * Copies a file to a given parent.
-  *
-  * <p>
-  *    Note that the <code>aParent</code> of the file must be a <code>sv:localFileRepository</code>, <code>sv:fileRepository</code>,
-  *    <code>sv:personalFileRepository</code> or a <code>sv:folder</code> residing as sub node to a file repository.
-  *    The <code>aParent</code> must not be trashed.
-  * </p>
-  * <p>
-  *    <strong>Permission note!</strong> Current user must be authorized to alter the parent node
-  *    (e.g. {@link senselogic.sitevision.api.security.PermissionUtil.Permission#WRITE}).
-  * </p>
-  *
-  * @param aFile the file node to copy
-  * @param aParent the parent node where the file should be copied to
-  * @return a file node corresponding to the newly created file
-  * @throws ConstraintViolationException if the user is not authorized to alter the parent node, if an invalid
-  *                                      parent node is specified, if an invalid file node is specified
-  * @throws RepositoryException          if something else goes wrong
-  * @since Sitevision 2026.01.1
-  */
+   * Copies a file to a given parent.
+   *
+   *  <p>
+   *     Note that the <code>aParent</code> of the file must be a <code>sv:localFileRepository</code>, <code>sv:fileRepository</code>,
+   *     <code>sv:personalFileRepository</code> or a <code>sv:folder</code> residing as sub node to a file repository.
+   *     The <code>aParent</code> must not be trashed.
+   *  </p>
+   *  <p>
+   *     <strong>Permission note!</strong> Current user must be authorized to alter the parent node
+   *     (e.g. {@link senselogic.sitevision.api.security.PermissionUtil.Permission#WRITE}).
+   *  </p>
+   * @param aFile the file node to copy
+   * @param aParent the parent node where the file should be copied to
+   * @return a file node corresponding to the newly created file
+   * @throws ConstraintViolationException if the user is not authorized to alter the parent node, if an invalid&#xA; parent node is specified, if an invalid file node is specified
+   * @throws RepositoryException if something else goes wrong
+   * @since Sitevision 2026.01.1
+   */
   copyFile(aFile: Node, aParent: Node): Node;
 
   /**

package/server/FolderUtil/index.d.ts

@@ -22,9 +22,8 @@ import type { String } from "../../types/java/lang/String";
  */
 export interface FolderUtil {
   /**
-   * <p>
-   *     Creates a folder as sub node of the specified parent.
-   *  </p>
+   * Creates a folder as sub node of the specified parent.
+   *
    *  <p>
    *     The parent may be either a {@code sv:sitePage}, {@code sv:page}, {@code sv:folder}, {@code sv:article}, {@code sv:collaborationGroupPage},
    *     {@code sv:imageRepository}, {@code sv:localImageRepository}, {@code sv:personalImageRepository},
@@ -33,10 +32,15 @@ export interface FolderUtil {
    *     If an other parent is specified an <code>ConstraintViolationException</code> is thrown.
    *  </p>
    *
-   *  <p>Any name can be given the folder. If null is provided a <code>NullPointerException</code> is thrown.</p>
+   *  <p>
+   *     Any name can be given the folder. If null is provided a <code>NullPointerException</code> is thrown.
+   *  </p>
    *
-   *  <p>The current user must be authorized to create folders and to do write operations on the parent node or
-   *  a <code>ConstraintViolationException</code> will be thrown.</p>
+   *  <p>
+   *     The current user must be authorized to create folders and to do write operations on the parent node or a
+   *     <code>ConstraintViolationException</code> will be thrown. <em>Note that creation of a folder in the sv:personalFileRepository or
+   *     sv:localImageRepository of a sv:collaborationGroup is also allowed for members of the group.</em>
+   *  </p>
    *
    *  <p>Note that a new folder inherits metadata and permissions from its parent.</p>
    * @param aParent the parent node of the sv:folder. May not be <code>null</code>
@@ -48,13 +52,22 @@ export interface FolderUtil {
   createFolder(aParent: Node, aName: String | string): Node;
 
   /**
-   * <p>Alters the name of a folder. If no folder is specified a <code>NullPointerException</code>
-   *  is thrown. If the node is not a sv:folder an <code>IllegalArgumentException</code> is thrown.</p>
+   * Alters the name of a folder.
+   *
+   *  <p>
+   *     If no folder is specified a <code>NullPointerException</code> is thrown.
+   *     If the node is not a sv:folder an <code>IllegalArgumentException</code> is thrown.
+   *  </p>
    *
-   *  <p>Any name can be given a folder. If null is provided a <code>NullPointerException</code> is thrown.</p>
+   *  <p>
+   *     Any name can be given a folder. If null is provided a <code>NullPointerException</code> is thrown.
+   *  </p>
    *
-   *  <p>The current user must be authorized to do write operations on the folder or
-   *  a <code>ConstraintViolationException</code> will be thrown.</p>
+   *  <p>
+   *     The current user must be authorized to do write operations on the folder or a <code>ConstraintViolationException</code> will be thrown.
+   *     <em>Note that rename of a folder in the sv:personalFileRepository or sv:localImageRepository of a sv:collaborationGroup is also allowed
+   *     for members of the group.</em>
+   *  </p>
    * @param aFolder the sv:folder that should be renamed. May not be <code>null</code>
    * @param aName the new name of the folder. May not be <code>null</code>
    * @throws ConstraintViolationException if the current user is not authorized to alter the name of the folder

package/server/ImageUtil/index.d.ts

@@ -59,10 +59,10 @@ export interface ImageUtil {
   createImages(aParent: Node, aImages: Map | {}): void;
 
   /**
-   * Creates an image using a uri string.
+   * Creates an image using an uri string.
    *
    *  <p>
-   *     Note that the <code>aParent</code> of the file must be a <code>sv:localImageRepository</code>, <code>sv:imageRepository</code>,
+   *     Note that the <code>aParent</code> for the image must be a <code>sv:localImageRepository</code>, <code>sv:imageRepository</code>,
    *     <code>sv:personalImageRepository</code> or a <code>sv:folder</code> residing as sub node to an image repository.
    *  </p>
    *  <p>
@@ -103,7 +103,7 @@ export interface ImageUtil {
    *     The decoder rejects data that contains characters outside the base64 alphabet.
    *  </p>
    *  <p>
-   *     Note that the <code>aParent</code> of the file must be a <code>sv:localImageRepository</code>, <code>sv:imageRepository</code>,
+   *     Note that the <code>aParent</code> for the image must be a <code>sv:localImageRepository</code>, <code>sv:imageRepository</code>,
    *     <code>sv:personalImageRepository</code> or a <code>sv:folder</code> residing as sub node to an image repository.
    *  </p>
    *  <p>
@@ -135,7 +135,7 @@ export interface ImageUtil {
    * Creates an image using a sv:temporaryFile.
    *
    *  <p>
-   *     Note that the <code>aParent</code> of the file must be a <code>sv:localImageRepository</code>, <code>sv:imageRepository</code>,
+   *     Note that the <code>aParent</code> for the image must be a <code>sv:localImageRepository</code>, <code>sv:imageRepository</code>,
    *     <code>sv:personalImageRepository</code> or a <code>sv:folder</code> residing as sub node to an image repository.
    *  </p>
    *  <p>
@@ -159,26 +159,24 @@ export interface ImageUtil {
   createImageFromTemporary(aParent: Node, aTemporaryFile: Node): Node;
 
   /**
-  * Copies an image to a given parent.
-  *
-  * <p>
-  *    Note that the <code>aParent</code> for the image must be a <code>sv:localImageRepository</code>, <code>sv:imageRepository</code>,
-  *    <code>sv:personalImageRepository</code> or a <code>sv:folder</code> residing as sub node to an image repository.
-  *    The <code>aParent</code> must not be trashed.
-  * </p>
-  * <p>
-  *    <strong>Permission note!</strong> Current user must be authorized to alter the parent node
-  *    (e.g. {@link senselogic.sitevision.api.security.PermissionUtil.Permission#WRITE}).
-  * </p>
-  *
-  * @param aImage the image node to copy
-  * @param aParent the parent node where the image should be copied to
-  * @return an image node corresponding to the newly created image
-  * @throws ConstraintViolationException if the user is not authorized to alter the parent node, if an invalid
-  *                                      parent node is specified, if an invalid image node is specified
-  * @throws RepositoryException          if something else goes wrong
-  * @since Sitevision 2026.01.1
-  */
+   * Copies an image to a given parent.
+   *
+   *  <p>
+   *     Note that the <code>aParent</code> for the image must be a <code>sv:localImageRepository</code>, <code>sv:imageRepository</code>,
+   *     <code>sv:personalImageRepository</code> or a <code>sv:folder</code> residing as sub node to an image repository.
+   *     The <code>aParent</code> must not be trashed.
+   *  </p>
+   *  <p>
+   *     <strong>Permission note!</strong> Current user must be authorized to alter the parent node
+   *     (e.g. {@link senselogic.sitevision.api.security.PermissionUtil.Permission#WRITE}).
+   *  </p>
+   * @param aImage the image node to copy
+   * @param aParent the parent node where the image should be copied to
+   * @return an image node corresponding to the newly created image
+   * @throws ConstraintViolationException if the user is not authorized to alter the parent node, if an invalid&#xA; parent node is specified, if an invalid image node is specified
+   * @throws RepositoryException if something else goes wrong
+   * @since Sitevision 2026.01.1
+   */
   copyImage(aImage: Node, aParent: Node): Node;
 
   /**

package/server/OutputUtil/index.d.ts

@@ -298,8 +298,12 @@ export interface OutputUtil extends OutputUtilConstants {
    * Gets the output as a specific content-type from a page node or a page content node.
    *
    *  <p>
-   *     <em>Tip! Consider using {@link TextModuleRenderer} instead if you want the output of a single Text module.</em>
+   *     <em>Tip!</em> This method has two versatile siblings that might be more suitable depending on your use case:
    *  </p>
+   *  <ul>
+   *     <li>Consider using {@link TextModuleRenderer} instead if you want the output of one or more Text modules.</li>
+   *     <li>Consider using {@link ContentRenderer} instead if you want the output of arbitrary page content (layouts, modules).</li>
+   *  </ul>
    *
    *  <p>
    *     <strong>Note! Due to security reasons (potential never-ending loops) it is prohibited to get the output of anything from

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

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

package/server/PermissionUtil.Permission/index.js

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

package/server/RendererBuilderFactory/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * This file is auto generated from JavaDoc. Do not modify it manually.
+ */
+import type { TextModuleRendererBuilder } from "../TextModuleRendererBuilder";
+import type { ContentRendererBuilder } from "../ContentRendererBuilder";
+
+/**
+ * Factory for creating various builders for rendering page content.
+ *
+ *  <p>
+ *     Currently, the factory can create builders for rendering of <strong>content nodes on a given page</strong>:
+ *  </p>
+ *  <ul>
+ *     <li>Use {@link #getTextModuleRendererBuilder()} to create a renderer for Text modules.</li>
+ *     <li>Use {@link #getContentRendererBuilder()} to create a renderer for other type of content nodes (i.e. layouts, modules etc).</li>
+ *  </ul>
+ *
+ *  <p>
+ *     An instance of the Sitevision class implementing this interface can be obtained via
+ *     {@link senselogic.sitevision.api.Utils#getRendererBuilderFactory()}.
+ *     See {@link senselogic.sitevision.api.Utils} for how to obtain an instance of the <code>Utils</code> interface.
+ *  </p>
+ * @author Magnus Lövgren
+ * @since Sitevision 2026.01.1
+ */
+export interface RendererBuilderFactory {
+  /**
+   * Gets a TextModuleRendererBuilder instance.
+   * @return a TextModuleRendererBuilder instance
+   */
+  getTextModuleRendererBuilder(): TextModuleRendererBuilder;
+
+  /**
+   * Gets a ContentRendererBuilder instance.
+   * @return a ContentRendererBuilder instance
+   */
+  getContentRendererBuilder(): ContentRendererBuilder;
+}
+
+declare namespace RendererBuilderFactory {}
+
+declare var rendererBuilderFactory: RendererBuilderFactory;
+
+export default rendererBuilderFactory;

package/server/RendererBuilderFactory/index.js

@@ -0,0 +1,13 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+/**
+ * This file is auto generated. Do not modify it manually.
+ */
+var _default = exports["default"] = {
+  getTextModuleRendererBuilder: function getTextModuleRendererBuilder() {},
+  getContentRendererBuilder: function getContentRendererBuilder() {}
+};

package/server/TagUtil/index.d.ts

@@ -47,7 +47,8 @@ export interface TagUtil {
    *
    *  <p>
    *     <strong>Permission note:</strong> Current user must have {@link senselogic.sitevision.api.security.PermissionUtil.Permission#WRITE WRITE}
-   *     permission on the taggable Node that is mutated.
+   *     permission on the taggable Node that is mutated. <em>Note that members of a sv:collaborationGroup is also allowed to add tags
+   *     for the group files.</em>
    *  </p>
    *  <p>
    *     <strong>Versioning note:</strong> Mutation of the taggable Node is always executed in the
@@ -68,7 +69,8 @@ export interface TagUtil {
    *
    *  <p>
    *     <strong>Permission note:</strong> Current user must have {@link senselogic.sitevision.api.security.PermissionUtil.Permission#WRITE WRITE}
-   *     permission on the taggable Node that is mutated.
+   *     permission on the taggable Node that is mutated. <em>Note that members of a sv:collaborationGroup is also allowed to add tags
+   *     for the group files.</em>
    *  </p>
    *  <p>
    *     <strong>Versioning note:</strong> Mutation of the taggable Node is always executed in the
@@ -99,7 +101,8 @@ export interface TagUtil {
    *
    *  <p>
    *     <strong>Permission note:</strong> Current user must have {@link senselogic.sitevision.api.security.PermissionUtil.Permission#WRITE WRITE}
-   *     permission on the taggable Node that is mutated.
+   *     permission on the taggable Node that is mutated. <em>Note that members of a sv:collaborationGroup is also allowed to remove tags
+   *     for the group files.</em>
    *  </p>
    *  <p>
    *     <strong>Versioning note:</strong> Mutation of the taggable Node is always executed in the

package/server/TextModuleRendererBuilder/index.d.ts

@@ -45,8 +45,8 @@ import type { Builder } from "../../types/senselogic/sitevision/api/base/Builder
  *
  *  <p>
  *     An instance of the Sitevision class implementing this interface can be obtained via
- *     {@link senselogic.sitevision.api.Utils#getTextModuleRendererBuilder()}.
- *     See {@link senselogic.sitevision.api.Utils} for how to obtain an instance of the <code>TextModuleRendererBuilder</code> interface.
+ *     {@link RendererBuilderFactory#getTextModuleRendererBuilder()}.
+ *     See {@link RendererBuilderFactory} for how to obtain an instance of the <code>RendererBuilderFactory</code> interface.
  *  </p>
  * @author Magnus Lövgren
  * @since Sitevision 7

package/server/Utils/index.d.ts

@@ -90,6 +90,8 @@ import type { TagUtil } from "../TagUtil";
 import type { AliasUtil } from "../AliasUtil";
 import type { MessagesFactory } from "../MessagesFactory";
 import type { TargetAudienceUtil } from "../TargetAudienceUtil";
+import type { RendererBuilderFactory } from "../RendererBuilderFactory";
+import type { CreateContentFactory } from "../CreateContentFactory";
 
 /**
  * Main entry point to get instances of interfaces in the Sitevision Utility API.
@@ -754,6 +756,20 @@ export interface Utils {
    * @since Sitevision 2024.09.2
    */
   getTargetAudienceUtil(): TargetAudienceUtil;
+
+  /**
+   * Gets an instance of a renderer builder factory class.
+   * @return a renderer builder factory class
+   * @since Sitevision 2026.01.1
+   */
+  getRendererBuilderFactory(): RendererBuilderFactory;
+
+  /**
+   * Gets an instance of a content builder factory.
+   * @return a content builder factory.
+   * @since Sitevision 2026.01.1
+   */
+  getCreateContentFactory(): CreateContentFactory;
 }
 
 declare namespace Utils {}

package/server/Utils/index.js

@@ -92,5 +92,7 @@ var _default = exports["default"] = {
   getTagUtil: function getTagUtil() {},
   getAliasUtil: function getAliasUtil() {},
   getMessagesFactory: function getMessagesFactory() {},
-  getTargetAudienceUtil: function getTargetAudienceUtil() {}
+  getTargetAudienceUtil: function getTargetAudienceUtil() {},
+  getRendererBuilderFactory: function getRendererBuilderFactory() {},
+  getCreateContentFactory: function getCreateContentFactory() {}
 };

package/server/ai/index.d.ts

@@ -1,5 +1,22 @@
 import type { Node } from '../../types/javax/jcr/Node';
 
+/**
+ * Represents a text part of a message.
+ */
+export interface TextPart {
+  type: 'text';
+  text: string;
+}
+
+/**
+ * Represents an image part of a message.
+ */
+export interface ImagePart {
+  type: 'image';
+  image: string;
+  mimeType: string;
+}
+
 /**
  * Represents a message in an AI conversation.
  */
@@ -14,8 +31,9 @@ export interface Message {
 
   /**
    * The actual content of the message.
+   * Can be either a string or an array of text and image parts.
    */
-  content: string;
+  content: string | Array<TextPart | ImagePart>;
 }
 
 /**

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

@@ -0,0 +1,127 @@
+/**
+ * This file is auto generated from JavaDoc. Do not modify it manually.
+ */
+import type { Node } from "../../../../../javax/jcr/Node";
+
+import type { String } from "../../../../../java/lang/String";
+
+/**
+ * ContentRenderer is a stateful renderer of content on a specific page.
+ *
+ *  <p>
+ *     This rendering utility is a page content-specific sibling to {@link OutputUtil#getNodeOutput(Node, Node, int)}
+ *     but it has some nifty advantages:
+ *  </p>
+ *  <ul>
+ *     <li>
+ *        This renderer is more <em>efficient</em> than {@code OutputUtil} for subsequent rendering of page content.
+ *     </li>
+ *     <li>
+ *        This renderer provides <em>convenience methods</em> for easy access of page content to render.
+ *     </li>
+ *     <li>
+ *        This renderer can use request <em>parameters</em> when rendering page content (if created via the {@link ContentRendererBuilder}).
+ *     </li>
+ *  </ul>
+ *
+ *  <p>
+ *     <strong>Note!</strong> This renderer has generic support for page content (i.e. modules, layouts etc.)
+ *     but if you should render <em>Text modules</em> - you should use {@link TextModuleRenderer} instead!
+ *     The TextModuleRenderer is much, much more efficient and provides more versatile behaviour when rendering text modules.
+ *  </p>
+ *
+ *  <p>
+ *    Using the ContentRenderer is pretty straightforward, if you remember that it is <strong>stateful</strong> and it adheres to an immutable page
+ *    determined at creation time.<br>
+ *    Conceptually you would typically use it like this:
+ *  </p>
+ *  <ol>
+ *    <li>Get the ContentRenderer for a specific page and parameters via {@link ContentRendererBuilder}.</li>
+ *    <li>Update the renderer with a content node on the page.</li>
+ *    <li>Check if the renderer is loaded (i.e. could the update process resolve a valid/renderable content node).</li>
+ *    <li>Do render</li>
+ *  </ol>
+ *  <p>
+ *     When you have rendered once, you can re-use the ContentRenderer until you are done. Something like:
+ *  </p>
+ *  <ol>
+ *    <li>Update the renderer with a another content node on the page.</li>
+ *    <li>Check if the renderer is loaded (i.e. could the update process resolve a valid/renderable content node).</li>
+ *    <li>Do render</li>
+ *  </ol>
+ *
+ *  <p>
+ *     An instance of the Sitevision class implementing this interface can be obtained via
+ *     {@link ContentRendererBuilder#build()} .
+ *     See {@link ContentRendererBuilder} for how to obtain an instance of the <code>ContentRendererBuilder</code> interface.
+ *  </p>
+ * @author Magnus Lövgren
+ * @since Sitevision 2026.01.1
+ * @see ContentRendererBuilder
+ */
+export type ContentRenderer = {
+  /**
+   * Updates the state of this renderer using a content Node.
+   *
+   *  <p>
+   *     <em>
+   *        Note! If this state update fails (i.e. argument was null or not specifying a supported content part that exists on the page
+   *        this renderer was created for) there will be nothing to render. The state can always be checked via the
+   *        {@link #isLoaded()} method.
+   *     </em>
+   *  </p>
+   * @param aContentNode the content node, typically a sv:portlet, sv:layout or sv:referenceLayout
+   */
+  update(aContentNode: Node): void;
+
+  /**
+   * Updates the state of this renderer using the identifier of a content Node.
+   *
+   *  <p>
+   *     The "identifier" is the JCR Node identifier (also the <code>jcr:uuid</code> property) of the content node.
+   *  </p>
+   *  <p>
+   *     <em>
+   *        Note! If this state update fails (i.e. argument was null or not specifying a supported content part that exists on the page
+   *        this renderer was created for) there will be nothing to render. The state can always be checked via the
+   *        {@link #isLoaded()} method.
+   *     </em>
+   *  </p>
+   * @param aNodeIdentifier the node identifier that specifies the content node (typically a sv:portlet, sv:layout or sv:referenceLayout)
+   */
+  updateByIdentifier(aNodeIdentifier: String | string): void;
+
+  /**
+   * Updates the state of this renderer using the content identifier of a content Node.
+   *
+   *  <p>
+   *     The "content identifier" is the <code>contentIdentifier</code> property for the sv:portlet on the context page.
+   *  </p>
+   *  <p>
+   *     <em>
+   *        Note! If this state update fails (i.e. argument was null or not specifying a supported content part that exists on the page
+   *        this renderer was created for) there will be nothing to render. The state can always be checked via the
+   *        {@link #isLoaded()} method.
+   *     </em>
+   *  </p>
+   * @param aContentIdentifier the content identifier that specifies the content node (i.e. a sv:portlet)
+   */
+  updateByContentIdentifier(aContentIdentifier: String | string): void;
+
+  /**
+   * Whether this renderer has been updated with a renderable content Node.
+   * @return true if this renderer has a valid content Node to render, false otherwise
+   */
+  isLoaded(): boolean;
+
+  /**
+   * Renders html for the loaded content node.
+   *
+   *  <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>
+   *  </p>
+   * @return the html of the loaded content node, or empty String if rendering fails or no content node is loaded
+   */
+  renderHtml(): string;
+};

package/types/senselogic/sitevision/api/render/ContentRenderer/index.js

@@ -0,0 +1,16 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+/**
+ * This file is auto generated. Do not modify it manually.
+ */
+var _default = exports["default"] = {
+  update: function update() {},
+  updateByIdentifier: function updateByIdentifier() {},
+  updateByContentIdentifier: function updateByContentIdentifier() {},
+  isLoaded: function isLoaded() {},
+  renderHtml: function renderHtml() {}
+};

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

@@ -170,19 +170,40 @@ export type TextModuleRenderer = {
    * Updates the state of this renderer (potentially "loads" a Text module for rendering) using the identifier of a Text module Node.
    *
    *  <p>
+   *     The "identifier" is the JCR Node identifier (also the <code>jcr:uuid</code> property) of the Text module.
+   *  </p>
+   *  <p>
    *     <em>
    *        Note! If this state update fails (i.e. argument was null or not specifying a supported Text module that exists on the page
    *        this renderer was created for) there will be nothing to render. The state can always be checked via the
    *        {@link #isLoaded()} method.
    *     </em>
    *  </p>
-   * @param aTextModuleIdentifier the identifier of the Text module
+   * @param aTextModuleIdentifier the node identifier of the Text module
    */
   updateByIdentifier(aTextModuleIdentifier: String | string): void;
 
   /**
-   * Whether or not this renderer has been updated with a renderable text module.
-   * @return true if this renderer has a valid text module to render, false otherwise
+   * Updates the state of this renderer (potentially "loads" a Text module for rendering) using the content identifier that specifies a Text module.
+   *
+   *  <p>
+   *     The "content identifier" is the <code>contentIdentifier</code> property of the sv:portlet (i.e. a Text module).
+   *  </p>
+   *  <p>
+   *     <em>
+   *        Note! If this state update fails (i.e. argument was null or not specifying a supported Text module that exists on the page
+   *        this renderer was created for) there will be nothing to render. The state can always be checked via the
+   *        {@link #isLoaded()} method.
+   *     </em>
+   *  </p>
+   * @param aContentIdentifier the content identifier that specifies the Text module
+   * @since Sitevision 2026.01.1
+   */
+  updateByContentIdentifier(aContentIdentifier: String | string): void;
+
+  /**
+   * Whether this renderer has been updated with a renderable Text module.
+   * @return true if this renderer has a valid Text module to render, false otherwise
    */
   isLoaded(): boolean;
 

package/types/senselogic/sitevision/api/render/TextModuleRenderer/index.js

@@ -11,6 +11,7 @@ var _default = exports["default"] = {
   update: function update() {},
   updateByName: function updateByName() {},
   updateByIdentifier: function updateByIdentifier() {},
+  updateByContentIdentifier: function updateByContentIdentifier() {},
   isLoaded: function isLoaded() {},
   renderHtml: function renderHtml() {},
   renderText: function renderText() {},

package/types/senselogic/sitevision/api/webresource/webcontent/TextModuleCreator/index.d.ts

@@ -0,0 +1,157 @@
+/**
+ * This file is auto generated from JavaDoc. Do not modify it manually.
+ */
+import type { String } from "../../../../../../java/lang/String";
+import type { Node } from "../../../../../../javax/jcr/Node";
+import type ContentFormat from "../../../../../../../server/ContentFormat";
+
+/**
+ * Builder for creating new text modules (text portlets).
+ *
+ *  <p>
+ *  <strong>Required configuration:</strong>
+ *  </p>
+ *  <ul>
+ *    <li>Parent - the page, layout or portlet where the text module will be created</li>
+ *    <li>Content - the text content and its format</li>
+ *  </ul>
+ *
+ *  <p>
+ *     <strong>Optional configuration:</strong>
+ *  </p>
+ *  <ul>
+ *     <li>Name - the display name/title of the text module</li>
+ *  </ul>
+ *
+ *  <p>
+ *  <strong>Usage example:</strong>
+ *  </p>
+ *  <pre><code>
+ *     const factory = utils.getCreateContentFactory();
+ *
+ *     const creator = factory.getTextModuleCreator();
+ *     creator
+ *        .setName('Welcome Message')
+ *        .setParent(pageNode)
+ *        .setMarkdownContent('# Welcome\n\nThis is a **welcome** message.');
+ *
+ *     // Optionally check if configuration is valid before executing
+ *     if (creator.isValid()) {
+ *        const node = creator.execute();
+ *     }
+ *  </code></pre>
+ *
+ *  <p>
+ *  <strong>Permission requirements:</strong>
+ *  </p>
+ *  <p>
+ *  The current user must have permission to update the parent page. An exception will be
+ *  thrown during {@link #execute()} if the user lacks the necessary permissions.
+ *  </p>
+ *
+ *  <p>
+ *  An instance of the Sitevision class implementing this interface can be obtained via
+ *  {@link senselogic.sitevision.api.webresource.webcontent.CreateContentFactory#getTextModuleCreator()}.
+ *  See {@link senselogic.sitevision.api.webresource.webcontent.CreateContentFactory} for how to
+ *  obtain an instance of the <code>CreateContentFactory</code> interface.
+ *  </p>
+ * @author Jens Kalshoven
+ * @since Sitevision 2026.01.1
+ */
+export type TextModuleCreator = {
+  /**
+   * Sets the display name of the text module to be created.
+   *
+   *  <p>
+   *  The name is displayed as the portlet title and should be descriptive.
+   *  </p>
+   * @param aName The name of the text module
+   * @return This builder instance for method chaining
+   */
+  setName(aName: String | string): TextModuleCreator;
+
+  /**
+   * Sets the parent node where the text module will be created.
+   *
+   *  <p>
+   *  The parent can be either:
+   *  </p>
+   *  <ul>
+   *    <li>Page (e.g. sv:page, sv:article) - the text module will be appended to the first layout on the page</li>
+   *    <li>Layout (e.g. sv:layout) - the text module will be appended to the layout</li>
+   *    <li>Module (sv:portlet) - the text module will be inserted after the module</li>
+   *  </ul>
+   *
+   *  <p>
+   *  This is a required configuration parameter.
+   *  </p>
+   * @param aParent The parent node. Must be a valid page or content node
+   * @return This builder instance for method chaining
+   */
+  setParent(aParent: Node): TextModuleCreator;
+
+  /**
+   * Sets the content of the text module using Markdown format.
+   *
+   *  <p>
+   *  This is a convenience method equivalent to calling
+   *  {@code setContent(aMarkdownContent, ContentFormat.MARKDOWN)}.
+   *  The Markdown content will be parsed and converted to rich text elements.
+   *  </p>
+   *
+   *  <p>
+   *  See {@link ContentFormat#MARKDOWN} for details on supported syntax.
+   *  </p>
+   * @param aMarkdownContent The Markdown content. Must not be null or empty
+   * @return This builder instance for method chaining
+   */
+  setMarkdownContent(aMarkdownContent: String | string): TextModuleCreator;
+
+  /**
+   * Sets the content of the text module with an explicit format.
+   *
+   *  <p>
+   *  This method allows you to specify the content and its format explicitly.
+   *  The content will be parsed according to the specified format and converted
+   *  to rich text elements.
+   *  </p>
+   * @param aContent The text content. Must not be null or empty
+   * @param aContentFormat The format of the content. Must not be null
+   * @return This builder instance for method chaining
+   */
+  setContent(
+    aContent: String | string,
+    aContentFormat: ContentFormat
+  ): TextModuleCreator;
+
+  /**
+   * Best-attempt validation of the current builder configuration.
+   *
+   *  <p>
+   *  Checks if all required parameters are set and valid:
+   *  </p>
+   *  <ul>
+   *    <li>Parent is not null and is a valid page, layout or portlet</li>
+   *    <li>Content is not null and not empty</li>
+   *    <li>Content format is not null</li>
+   *    <li>The page is not trashed</li>
+   *    <li>The user has permission to update the page</li>
+   *  </ul>
+   * @return true if the configuration is valid, false otherwise
+   */
+  isValid(): boolean;
+
+  /**
+   * Creates the text module with the configured settings.
+   *
+   *  <p>
+   *  <strong>Important:</strong> This method modifies the {@link senselogic.sitevision.api.versioning.VersionUtil#OFFLINE_VERSION}
+   *  of the page content and saves the changes. The operation is performed under a lock to ensure consistency.
+   *  </p>
+   * @return The newly created sv:portlet node
+   * @throws IllegalStateException If the configuration is invalid
+   * @throws ConstraintViolationException If the parent is invalid, or the user lacks permission to update the page, or the page is trashed
+   * @throws RepositoryException If something else goes wrong
+   */
+  execute(): Node;
+};

package/types/senselogic/sitevision/api/webresource/webcontent/TextModuleCreator/index.js

@@ -0,0 +1,17 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+/**
+ * This file is auto generated. Do not modify it manually.
+ */
+var _default = exports["default"] = {
+  setName: function setName() {},
+  setParent: function setParent() {},
+  setMarkdownContent: function setMarkdownContent() {},
+  setContent: function setContent() {},
+  isValid: function isValid() {},
+  execute: function execute() {}
+};

package/types/senselogic/sitevision/api/webresource/webcontent/TextModuleUpdater/index.d.ts

@@ -0,0 +1,147 @@
+/**
+ * This file is auto generated from JavaDoc. Do not modify it manually.
+ */
+import type { Node } from "../../../../../../javax/jcr/Node";
+import type { String } from "../../../../../../java/lang/String";
+import type ContentFormat from "../../../../../../../server/ContentFormat";
+
+/**
+ * Builder for updating existing text modules (text portlets) with new content.
+ *
+ *  <p>
+ *  <strong>Required configuration:</strong>
+ *  </p>
+ *  <ul>
+ *    <li>Text module - the existing text module node to update</li>
+ *    <li>Content - the new text content and its format</li>
+ *  </ul>
+ *
+ *  <p>
+ *  <strong>Usage example:</strong>
+ *  </p>
+ *  <pre><code>
+ *     const factory = utils.getCreateContentFactory();
+ *
+ *     const updater = factory.getTextModuleUpdater();
+ *     updater
+ *        .setTextModule(existingTextModuleNode)
+ *        .setMarkdownContent('# Updated Title\n\nThis content has been **updated**.');
+ *
+ *     // Optionally check if configuration is valid before executing
+ *     if (updater.isValid()) {
+ *        const node = updater.execute();
+ *     }
+ *  </code></pre>
+ *
+ *  <p>
+ *  <strong>Important notes:</strong>
+ *  </p>
+ *  <ul>
+ *    <li>The update operation replaces the entire content of the text module</li>
+ *    <li>The text module must be a text portlet (portlet ID "text")</li>
+ *    <li>The text module must be on a page</li>
+ *  </ul>
+ *
+ *  <p>
+ *  <strong>Permission requirements:</strong>
+ *  </p>
+ *  <p>
+ *  The current user must have permission to update the parent page. An exception will be
+ *  thrown during {@link #execute()} if the user lacks the necessary permissions.
+ *  </p>
+ *
+ *  <p>
+ *  An instance of the Sitevision class implementing this interface can be obtained via
+ *  {@link senselogic.sitevision.api.webresource.webcontent.CreateContentFactory#getTextModuleUpdater()}.
+ *  See {@link senselogic.sitevision.api.webresource.webcontent.CreateContentFactory} for how to
+ *  obtain an instance of the <code>CreateContentFactory</code> interface.
+ *  </p>
+ * @author Jens Kalshoven
+ * @since Sitevision 2026.01.1
+ */
+export type TextModuleUpdater = {
+  /**
+   * Sets the text module to be updated.
+   *
+   *  <p>
+   *  The node must be an existing text module sv:portlet (portlet ID "text") that is
+   *  on a page. The entire content of this text module will be replaced when
+   *  {@link #execute()} is called.
+   *  </p>
+   *
+   *  <p>
+   *  This is a required configuration parameter.
+   *  </p>
+   * @param aTextModule the text module node to update, must be a valid text portlet
+   * @return This builder instance for method chaining
+   */
+  setTextModule(aTextModule: Node): TextModuleUpdater;
+
+  /**
+   * Sets the new content for the text module using Markdown format.
+   *
+   *  <p>
+   *  This is a convenience method equivalent to calling
+   *  {@code setContent(aMarkdownContent, ContentFormat.MARKDOWN)}.
+   *  The Markdown content will be parsed and converted to rich text elements,
+   *  replacing the existing content.
+   *  </p>
+   *
+   *  <p>
+   *  See {@link ContentFormat#MARKDOWN} for details on supported syntax.
+   *  </p>
+   * @param aMarkdownContent The new Markdown content, must not be null or empty
+   * @return This builder instance for method chaining
+   */
+  setMarkdownContent(aMarkdownContent: String | string): TextModuleUpdater;
+
+  /**
+   * Sets the new content for the text module with an explicit format.
+   *
+   *  <p>
+   *  This method allows you to specify the new content and its format explicitly.
+   *  The content will be parsed according to the specified format and converted
+   *  to rich text elements, replacing the existing content.
+   *  </p>
+   * @param aContent The new text content. Must not be null or empty
+   * @param aContentFormat The format of the content. Must not be null
+   * @return This builder instance for method chaining
+   */
+  setContent(
+    aContent: String | string,
+    aContentFormat: ContentFormat
+  ): TextModuleUpdater;
+
+  /**
+   * Best-effort validation of the current builder configuration.
+   *
+   *  <p>
+   *  Checks if all required parameters are set and valid:
+   *  </p>
+   *  <ul>
+   *    <li>Text module is not null and is a valid text portlet</li>
+   *    <li>Text module's parent is a page</li>
+   *    <li>Content is not null and not empty</li>
+   *    <li>Content format is not null</li>
+   *    <li>The page is not trashed</li>
+   *    <li>The user has permission to update the page</li>
+   *  </ul>
+   * @return true if the configuration is valid, false otherwise
+   */
+  isValid(): boolean;
+
+  /**
+   * Updates the text module with the new configured content.
+   *
+   *  <p>
+   *  <strong>Important:</strong> This method modifies {@link senselogic.sitevision.api.versioning.VersionUtil#OFFLINE_VERSION}
+   *  of the page content and saves the changes. The operation is performed under a lock to ensure consistency. The entire existing
+   *  content of the text module is replaced.
+   *  </p>
+   * @return The updated sv:portlet node
+   * @throws IllegalStateException If the configuration is invalid
+   * @throws ConstraintViolationException If the targeted textModule is invalid,&#xA; or the user lacks permission to update the page,&#xA; or the page is trashed
+   * @throws RepositoryException If something else goes wrong
+   */
+  execute(): Node;
+};

package/types/senselogic/sitevision/api/webresource/webcontent/TextModuleUpdater/index.js

@@ -0,0 +1,16 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+/**
+ * This file is auto generated. Do not modify it manually.
+ */
+var _default = exports["default"] = {
+  setTextModule: function setTextModule() {},
+  setMarkdownContent: function setMarkdownContent() {},
+  setContent: function setContent() {},
+  isValid: function isValid() {},
+  execute: function execute() {}
+};