4d · arnaud4d · Jun 3, 2026 · Apr 14, 2026 · Apr 14, 2026 · Apr 14, 2026
diff --git a/.doc_preprocessing.js b/.doc_preprocessing.js
@@ -1,9 +1,24 @@
+const fs = require("fs")
+
 const PREPROCESSING_TARGET_SYNTAX = process.env.PREPROCESSING_TARGET_SYNTAX
 let target_syntax = "docs"
 let target_syntax_translate = "current"
 
 if(PREPROCESSING_TARGET_SYNTAX) {
-    target_syntax = "versioned_docs/" + PREPROCESSING_TARGET_SYNTAX
+    const versionDir = "versioned_docs/" + PREPROCESSING_TARGET_SYNTAX
+    if (!fs.existsSync(versionDir)) {
+        const available = fs.existsSync("versioned_docs")
+            ? fs.readdirSync("versioned_docs").filter(n => n.startsWith("version-"))
+            : []
+        console.error(
+            `\x1b[31mERROR\x1b[0m: PREPROCESSING_TARGET_SYNTAX="${PREPROCESSING_TARGET_SYNTAX}" ` +
+            `but folder "${versionDir}" does not exist.\n` +
+            `Available versions: ${available.join(", ") || "(none)"}\n` +
+            `Leave PREPROCESSING_TARGET_SYNTAX unset to build the current (docs/) version.`
+        )
+        process.exit(1)
+    }
+    target_syntax = versionDir
     target_syntax_translate = PREPROCESSING_TARGET_SYNTAX
 }
 

diff --git a/docs/API/IMAPTransporterClass.md b/docs/API/IMAPTransporterClass.md
@@ -1442,8 +1442,14 @@ $flags["$seen"]:=True
 $status:=$transporter.removeFlags(IMAP all;$flags)
 ```
 
+#### See also
+
+[`.addFlags()`](#addflags) 
+
 <!-- END REF -->
 
+
+
 <!-- REF IMAPTransporterClass.renameBox().Desc -->
 ## .renameBox()
 

diff --git a/docs/FormObjects/properties_Text.md b/docs/FormObjects/properties_Text.md
@@ -427,6 +427,7 @@ This property enables the possibility of using [specific styles](https://doc.4d.
 
 By default, this option is not enabled.
 
+
 #### JSON Grammar
 
 |Name|Data Type|Possible Values|
@@ -439,7 +440,86 @@ By default, this option is not enabled.
 
 #### Commands
 
-[LISTBOX Get property](../commands/listbox-get-property) - [LISTBOX SET PROPERTY](../commands/listbox-set-property) - [OBJECT Is styled text](../commands/object-is-styled-text) - 
+[LISTBOX Get property](../commands/listbox-get-property) - [LISTBOX SET PROPERTY](../commands/listbox-set-property) - [OBJECT Is styled text](../commands/object-is-styled-text)
+
+### Supported tags  
+
+You can use the following tags in 4D multi-style text areas.
+
+#### 4D Expression  
+
+```html
+<span style="-d4-ref:'expression'"> </span>
+```
+
+This tag inserts a 4D expression (expression, method, field, variable, command, etc.) in the text. The expression is tokenized and evaluated:
+
+- when the expression is inserted
+- when the object is loaded
+- when the `computeExpressions` standard action is called from an interface object or by the [`INVOKE ACTION`](../commands/invoke-action) command
+- when the [`ST COMPUTE EXPRESSIONS`](../commands/st-compute-expressions) command is executed
+- when the [`ST FREEZE EXPRESSIONS`](../commands/st-freeze-expressions) command is executed, if the second `*` parameter is passed.
+
+The evaluated value of the expression is not saved in the `<span>` tag, only its reference is.
+
+Note: To ensure that expressions will be evaluated correctly regardless of the 4D language or version used, we recommend using the token syntax for elements whose name might vary between different versions (commands, tables, fields, constants). For example, to insert the `Current time` command, enter `Current time:C178`. For more information about this, refer to *Using tokens in formulas*.
+
+#### URL
+
+```html
+<span><a href="url">Visible label</a></span>
+```
+
+This tag inserts a URL in the text. Example:
+
+```html
+<span><a href="http://www.4d.com/">4D Web Site</a></span>
+```
+
+#### User link  
+
+```html
+<span style="-d4-ref-user:'myUserLink'">Click here</span>
+```
+
+"User links" look the same as URLs, but when you click them, they do not automatically open the source. You can pass any string you want as reference, and it is up to the developer to program any custom actions that occur when it is clicked. This means you can create links which are not URLs but references to files, 4D methods, and so on, that you can open or execute when they are clicked. The [`ST Get content type`](../commands/st-get-content-type) command detects if a user link has been clicked.
+
+User links are defined using the [`ST SET TEXT`](../commands/st-set-text) command. For example:
+
+```4d
+ST SET TEXT(txtVar;"This is a user link: <span style=\"-d4-ref-user:'UserLink'\">User Label</span>";$start;$end)
+ ```
+
+#### Custom tags  
+
+You can insert any tag in plain text, for example `<img src="http://doc.4d.com/pictures/ja.png">`. It is stored in the code of the plain text without being interpreted or displayed. This is particularly useful in the context of e-mails in HTML format and including pictures for example.
+
+#### Style tags  
+
+This paragraph lists the attributes of \<SPAN> tags that are supported by 4D in rich text areas. You can use these tags to implement custom style handling. Only the tags listed below are supported by 4D for style variations.
+
+- Font name: `<SPAN STYLE="font-family: DESDEMONA"> ... </SPAN>`
+- Font size: `<SPAN STYLE="font-size: 20pt"> ... </SPAN>`
+- Font style: 
+    - Bold `<SPAN STYLE="font-weight: bold"> ... </SPAN>`
+    - Italic `<SPAN STYLE="font-style: italic"> ... </SPAN>`
+    - Normal `<SPAN STYLE="font-style: normal"> ... </SPAN>`
+    - Underline `<SPAN STYLE="text-decoration: underline"> ... </SPAN>`
+    - Strikethrough `<SPAN STYLE="text-decoration:line-through">...</SPAN>`
+
+*Note: The "strikethrough" style is not supported under macOS, but this tag can still be managed by programming.*
+
+- Font colors: `<SPAN STYLE="color:green"> ... </SPAN>` or `<SPAN STYLE="color:#006CCC">...</SPAN>`
+- Background colors: `<SPAN STYLE="background-color:green"> ... </SPAN>` or `<SPAN STYLE="background-color:#006CCC">...</SPAN>`
+
+#### Color values
+
+For font color and background color attributes, the color value can be either the hexadecimal code for an RGB color, or the name of one of the 16 HTML colors defined for standard CSS by the W3C: 
+
+![](../assets/en/FormObjects/colors1.png)
+![](../assets/en/FormObjects/colors2.png)
+
+
 
 
 ---

diff --git a/docs/Notes/updates.md b/docs/Notes/updates.md
@@ -86,7 +86,7 @@ Read [**What’s new in 4D 21 R2**](https://blog.4d.com/whats-new-in-4d-21-r2/),
 |libZip|1.11.4|21|Used by zip class, 4D Write Pro, svg and serverNet components|
 |LZMA|5.8.1|21||
 |ngtcp2|1.22.1|**21 R4**|Used for QUIC|
-|OpenSSL|3.5.2|21||
+|OpenSSL|4.0|**21 R4**||
 |PDFWriter|4.7.0|21|Used for [`WP Export document`](../WritePro/commands/wp-export-document.md) and [`WP Export variable`](../WritePro/commands/wp-export-variable.md) |
 |SpreadJS|18.2.0|21 R2|See [this blog post](https://blog.4d.com/4d-view-pro-whats-new-in-4d-21-r2/) for an overview of the new features|
 |webKit|WKWebView|19||

diff --git a/docs/aikit/Classes/OpenAI.md b/docs/aikit/Classes/OpenAI.md
@@ -11,8 +11,8 @@ The `OpenAI` class provides a client for accessing various OpenAI API resources.
 
 | Property Name     | Type  | Description                       | Optional |
 |-------------------|-------|-----------------------------------|----------|
-| `apiKey`          | Text  | Your [OpenAI API Key](https://platform.openai.com/api-keys).              | Can be required by the provider|
-| `baseURL`         | Text  | Base URL for OpenAI API requests. | Yes (if omitted = use OpenAI Platform)|
+| `apiKey`          | Text  | Your [OpenAI API Key](https://developers.openai.com/api/docs/quickstart#create-and-export-an-api-key).              | Can be required by the provider |
+| `baseURL`         | Text  | Base URL for OpenAI API requests. | Yes (if omitted = use OpenAI Platform) |
 | `organization`    | Text  | Your OpenAI Organization ID.      | Yes      |
 | `project`         | Text  | Your OpenAI Project ID.           | Yes      |
 
@@ -69,7 +69,6 @@ The API provides access to multiple resources that allow seamless interaction wi
 | `embeddings`      | [OpenAIEmbeddingsAPI](OpenAIEmbeddingsAPI.md)   | Access to the Embeddings API.  |
 | `files`           | [OpenAIFilesAPI](OpenAIFilesAPI.md)             | Access to the Files API.       |
 
-
 ### Example Usage
 
 ```4d
@@ -82,3 +81,9 @@ $client.model.lists(...)
 ## Provider Model Aliases
 
 The OpenAI client supports provider model aliases for easy multi-provider usage. See [Provider Model Aliases](../provider-model-aliases.md) for complete documentation.
+
+You can construct an OpenAI client using a pre-configured provider name. This allows you to easily switch between different AI providers (OpenAI, Anthropic, etc.) without specifying the full configuration each time.
+
+```4d
+var $client:=cs.AIKit.OpenAI.new({provider: "anthropic"})
+```
diff --git a/docs/aikit/Classes/OpenAIAPIResource.md b/docs/aikit/Classes/OpenAIAPIResource.md
@@ -21,3 +21,4 @@ The client allow to make HTTP Request.
 - [OpenAIChatAPI](OpenAIChatAPI.md)
 - [OpenAIImagesAPI](OpenAIImagesAPI.md)
 - [OpenAIModerationsAPI](OpenAIModerationsAPI.md)
+- [OpenAIFilesAPI](OpenAIFilesAPI.md)
diff --git a/docs/aikit/Classes/OpenAIChatAPI.md b/docs/aikit/Classes/OpenAIChatAPI.md
@@ -25,7 +25,6 @@ The `OpenAIChatAPI` class provides an interface to interact with OpenAI's chat b
 | *systemPrompt*   | Text  | The system prompt to initialize the chat.  |
 | Function result | [OpenAIChatHelper](OpenAIChatHelper.md) | A helper instance for managing chat interactions. |
 
-
 #### Example Usage
 
 ```4D

diff --git a/docs/aikit/Classes/OpenAIChatCompletionsAPI.md b/docs/aikit/Classes/OpenAIChatCompletionsAPI.md
@@ -7,7 +7,7 @@ title: OpenAIChatCompletionsAPI
 
 The `OpenAIChatCompletionsAPI` class is designed for managing chat completions with OpenAI's API. It provides methods to create, retrieve, update, delete, and list chat completions.
 
-https://platform.openai.com/docs/api-reference/chat
+https://developers.openai.com/api/reference/resources/chat
 
 ## Functions
 
@@ -23,7 +23,7 @@ https://platform.openai.com/docs/api-reference/chat
 
 Creates a model response for the given chat conversation.
 
-https://platform.openai.com/docs/api-reference/chat/create
+https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create
 
 #### Example Usage
 
@@ -59,7 +59,7 @@ $messages.push($result.choice.message) // {"role":"assistant"; "content": "xxx"
 
 Get a stored chat completion.
 
-https://platform.openai.com/docs/api-reference/chat/get
+https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/retrieve
 
 ### update()
 
@@ -74,7 +74,7 @@ https://platform.openai.com/docs/api-reference/chat/get
 
 Modify a stored chat completion.
 
-https://platform.openai.com/docs/api-reference/chat/update
+https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/update
 
 ### delete()
 
@@ -88,7 +88,7 @@ https://platform.openai.com/docs/api-reference/chat/update
 
 Delete a stored chat compltions.
 
-https://platform.openai.com/docs/api-reference/chat/delete
+https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/delete
 
 ### list()
 
@@ -101,4 +101,4 @@ https://platform.openai.com/docs/api-reference/chat/delete
 
 List stored chat completions.
 
-https://platform.openai.com/docs/api-reference/chat/list
+https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/list
diff --git a/docs/aikit/Classes/OpenAIChatCompletionsMessagesAPI.md b/docs/aikit/Classes/OpenAIChatCompletionsMessagesAPI.md
@@ -21,4 +21,4 @@ The `OpenAIChatCompletionsMessagesAPI` class is designed to interact with the Op
 
 The `list()` function retrieves messages associated with a specific chat completion ID. It throws an error if the `completionID` is empty. If the *parameters* argument is not an instance of `OpenAIChatCompletionsMessagesParameters`, it will create a new instance using the provided parameters.
 
-https://platform.openai.com/docs/api-reference/chat/getMessages
+https://developers.openai.com/api/reference/resources/chat/subresources/completions/subresources/messages/methods/list
diff --git a/docs/aikit/Classes/OpenAIChatCompletionsParameters.md b/docs/aikit/Classes/OpenAIChatCompletionsParameters.md
@@ -1,43 +1,44 @@
 ---
 id: openaichatcompletionsparameters
-title: OpenAIChatCompletionParameters
+title: OpenAIChatCompletionsParameters
 ---
 
-# OpenAIChatCompletionParameters
+# OpenAIChatCompletionsParameters
 
-The `OpenAIChatCompletionParameters` class is designed to handle the parameters required for chat completions using the OpenAI API.
+The `OpenAIChatCompletionsParameters` class is designed to handle the parameters required for chat completions using the OpenAI API.
 
 ## Inherits
 
 - [OpenAIParameters](OpenAIParameters.md)
 
 ## Properties
 
-| Property                   | Type    | Default Value           | Description                                                                                       |
-|---------------------------|---------|-------------------------|---------------------------------------------------------------------------------------------------|
-| `model`                 | Text       | `"gpt-4o-mini"` | ID of the model to use. Supports [provider:model aliases](../provider-model-aliases.md) for multi-provider usage (e.g., `"openai:gpt-4o"`, `"anthropic:claude-3-opus"`).  |
-| `stream`                | Boolean    | `False`         | Whether to stream back partial progress. If set, tokens will be sent as data-only. Callback formula required.    |
-| `stream_options`        | Object     | `Null`          | Property for stream=True. For example: `{include_usage: True}`   |
+| Property                | Type       | Default Value   | Description                                                                                                                                              |
+| ----------------------- | ---------- | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `model`                 | Text       | `"gpt-4o-mini"` | ID of the model to use. Supports [provider:model aliases](../provider-model-aliases.md) for multi-provider usage (e.g., `"openai:gpt-4o"`, `"anthropic:claude-3-opus"`). |
+| `stream`                | Boolean    | `False`         | Whether to stream back partial progress. If set, tokens will be sent as data-only. Callback formula required.                                            |
+| `stream_options`        | Object     | `Null`          | Property for stream=True. For example: `{include_usage: True}`                                                                                           |
 | `max_completion_tokens` | Integer    | `0`             | The maximum number of tokens that can be generated in the completion.                                                                                    |
 | `n`                     | Integer    | `1`             | How many completions to generate for each prompt.                                                                                                        |
 | `temperature`           | Real       | `-1`            | What sampling temperature to use, between 0 and 2. Higher values make the output more random, while lower values make it more focused and deterministic. |
+| `top_p`                 | Real       | `-1`            | An alternative to sampling with temperature, called nucleus sampling, where the model considers the results of the tokens with top_p probability mass. So 0.1 means only the tokens comprising the top 10% probability mass are considered. Only sent when the value is greater than 0 (omitted when `<= 0`, with default `-1`). |
 | `store`                 | Boolean    | `False`         | Whether or not to store the output of this chat completion request.                                                                                      |
-| `reasoning_effort`      | Text       | `Null`          | Constrains effort on reasoning for reasoning models. Currently supported values are `"low"`, `"medium"`, and `"high"`.  |
-| `response_format`       | Object     | `Null`          | An object specifying the format that the model must output. Compatible with structured outputs.   |
-| `tools`                 | Collection | `Null`          | A list of tools ([OpenAITool](OpenAITool.md)) the model may call. Only "function" type is supported. |
-| `tool_choice`           | Variant    | `Null`          | Controls which (if any) tool is called by the model. Can be `"none"`, `"auto"`, `"required"`, or specify a particular tool. |
+| `reasoning_effort`      | Text       | `Null`          | Constrains effort on reasoning for reasoning models. Currently supported values are `"low"`, `"medium"`, and `"high"`.                                   |
+| `response_format`       | Object     | `Null`          | An object specifying the format that the model must output. Compatible with structured outputs.                                                          |
+| `tools`                 | Collection | `Null`          | A list of tools ([OpenAITool](OpenAITool.md)) the model may call. Only "function" type is supported.                                                                    |
+| `tool_choice`           | Variant    | `Null`          | Controls which (if any) tool is called by the model. Can be `"none"`, `"auto"`, `"required"`, or specify a particular tool.                              |
 | `prediction`            | Object     | `Null`          | Static predicted output content, such as the content of a text file that is being regenerated.                                                           |
+| `service_tier`          | Text       | `Null`          | Specifies the processing type used for serving the request. `"auto"`, `"auto"`, `"default"`, and `"priority"`.                                           |
 
 ### Asynchronous Callback Properties
 
-| Property | Type | Description | 
-|----------|------|-----------|
-| `onData` (or `formula`)  | 4D.Function  | A function to be called asynchronously when receiving data chunk. Ensure that the current process does not terminate. |
-
-`onData` will receive as argument an [OpenAIChatCompletionsStreamResult](./OpenAIChatCompletionsStreamResult.md).
+| Property                   | Type    | Description                                                                                       |
+|---------------------------|---------|-------------------------|---------------------------------------------------------------------------------------------------|
+| `onData`<br>(or `formula`)   | 4D.Function | A function to be called asynchronously when receiving data chunk.<br>*Ensure that the current process does not terminate.* |
 
-See [OpenAIParameters](./OpenAIParameters.md) for other callback properties.
+`onData` will receive as argument a [OpenAIChatCompletionsStreamResult](OpenAIChatCompletionsStreamResult.md)
 
+See [OpenAIParameters](OpenAIParameters.md) for other callback properties.
 
 ## Response Format
 
@@ -50,7 +51,7 @@ The `response_format` parameter allows you to specify the format that the model
 The default response format returns plain text:
 
 ```4d
-var $params := cs.OpenAIChatCompletionsParameters.new({ \
+var $params := cs.AIKit.OpenAIChatCompletionsParameters.new({ \
     model: "gpt-4o-mini"; \
     response_format: {type: "text"} \
 })
@@ -61,13 +62,13 @@ var $params := cs.OpenAIChatCompletionsParameters.new({ \
 Forces the model to respond with valid JSON:
 
 ```4d
-var $params := cs.OpenAIChatCompletionsParameters.new({ \
+var $params := cs.AIKit.OpenAIChatCompletionsParameters.new({ \
     model: "gpt-4o-mini"; \
     response_format: {type: "json_object"} \
 })
 
 var $messages := [ \
-    cs.OpenAIMessage.new({ \
+    cs.AIKit.OpenAIMessage.new({ \
         role: "system"; \
         content: "You are a helpful assistant that always responds in JSON format." \
     }) \
@@ -97,7 +98,7 @@ var $jsonSchema := { \
     additionalProperties: False \
 }
 
-var $params := cs.OpenAIChatCompletionsParameters.new({ \
+var $params := cs.AIKit.OpenAIChatCompletionsParameters.new({ \
     model: "gpt-4o-mini"; \
     response_format: { \
         type: "json_schema"; \
-Original file line number
+Diff line change
@@ Expand Up @@
     | *systemPrompt*   | Text  | The system prompt to initialize the chat.  |
     | Function result | [OpenAIChatHelper](OpenAIChatHelper.md) | A helper instance for managing chat interactions. |
     #### Example Usage
     ```4D
@@ Expand Down @@
Original file line number	Diff line number	Diff line change
Expand Up		@@ -21,4 +21,4 @@ The `OpenAIChatCompletionsMessagesAPI` class is designed to interact with the Op

		The `list()` function retrieves messages associated with a specific chat completion ID. It throws an error if the `completionID` is empty. If the parameters argument is not an instance of `OpenAIChatCompletionsMessagesParameters`, it will create a new instance using the provided parameters.

		https://platform.openai.com/docs/api-reference/chat/getMessages
		https://developers.openai.com/api/reference/resources/chat/subresources/completions/subresources/messages/methods/list