updates to reflect the new api changes

Author: stalep

content/docs/readline/clipboard.md

@@ -144,6 +144,20 @@ readline.readline(connection, new Prompt("$ "), input -> {
 }, null, null, null, null, flags);
 ```
 
+Or more concisely with `ReadlineRequest` and `ReadlineFlags`:
+
+```java
+import org.aesh.readline.ReadlineRequest;
+import org.aesh.readline.ReadlineFlags;
+
+readline.readline(ReadlineRequest.builder()
+        .connection(connection)
+        .prompt("$ ")
+        .requestHandler(input -> { /* handle input */ })
+        .flags(ReadlineFlags.of(ReadlineFlag.NO_CLIPBOARD))
+        .build());
+```
+
 ## Manual Usage
 
 For applications that manage their own rendering (outside of `Readline`), use the `Connection` method directly:

content/docs/readline/connectivity.md

@@ -416,8 +416,8 @@ public class WebTerminal {
 
     public static synchronized void main(String[] args) throws Exception {
         NettyWebsocketTtyBootstrap bootstrap = new NettyWebsocketTtyBootstrap()
-                .setHost("localhost")
-                .setPort(8080);
+                .host("localhost")
+                .port(8080);
 
         bootstrap.start(WebTerminal::handleConnection).get(10, TimeUnit.SECONDS);
 
@@ -451,10 +451,10 @@ public class WebTerminal {
 
 | Method | Type | Description |
 |--------|------|-------------|
-| `setHost(String)` | `String` | Bind address (default: "localhost") |
-| `setPort(int)` | `int` | HTTP port (default: 8080) |
-| `setResourcePath(String)` | `String` | Classpath path for static files (default: "/org/aesh/terminal/http") |
-| `setServeStaticFiles(boolean)` | `boolean` | Enable/disable static file serving (default: true) |
+| `host(String)` | `String` | Bind address (default: "localhost") |
+| `port(int)` | `int` | HTTP port (default: 8080) |
+| `resourcePath(String)` | `String` | Classpath path for static files (default: "/org/aesh/terminal/http") |
+| `serveStaticFiles(boolean)` | `boolean` | Enable/disable static file serving (default: true) |
 
 The WebSocket endpoint is always available at `/ws`.
 
@@ -465,9 +465,9 @@ By default, terminal-http serves a built-in HTML page with xterm.js. To use your
 ```java
 // Use custom resources from your classpath
 NettyWebsocketTtyBootstrap bootstrap = new NettyWebsocketTtyBootstrap()
-        .setHost("localhost")
-        .setPort(8080)
-        .setResourcePath("/com/myapp/web");  // Your classpath location
+        .host("localhost")
+        .port(8080)
+        .resourcePath("/com/myapp/web");  // Your classpath location
 ```
 
 Place your `index.html` at `src/main/resources/com/myapp/web/index.html`.
@@ -510,9 +510,9 @@ For applications that serve HTML from a separate web server:
 ```java
 // Disable static file serving - only handle WebSocket at /ws
 NettyWebsocketTtyBootstrap bootstrap = new NettyWebsocketTtyBootstrap()
-        .setHost("localhost")
-        .setPort(8080)
-        .setServeStaticFiles(false);
+        .host("localhost")
+        .port(8080)
+        .serveStaticFiles(false);
 ```
 
 ### Browser Client with xterm.js
@@ -864,7 +864,7 @@ public class MultiProtocolServer {
 
         // WebSocket on port 8080
         NettyWebsocketTtyBootstrap http = new NettyWebsocketTtyBootstrap()
-                .setPort(8080);
+                .port(8080);
 
         // Start all servers
         ssh.start();

content/docs/readline/edit-modes.md

@@ -14,12 +14,12 @@ import org.aesh.readline.editing.EditMode;
 import org.aesh.readline.editing.EditModeBuilder;
 
 // Create default edit mode (Emacs)
-EditMode editMode = EditModeBuilder.builder().create();
+EditMode editMode = EditModeBuilder.builder().build();
 
 // Create Vi mode
 EditMode viMode = EditModeBuilder.builder()
         .mode(EditMode.Mode.VI)
-        .create();
+        .build();
 ```
 
 ## Emacs Mode
@@ -34,7 +34,7 @@ import org.aesh.readline.ReadlineBuilder;
 Readline readline = ReadlineBuilder.builder()
         .editMode(EditModeBuilder.builder()
                 .mode(EditMode.Mode.EMACS)
-                .create())
+                .build())
         .build();
 ```
 
@@ -75,7 +75,7 @@ import org.aesh.readline.ReadlineBuilder;
 Readline readline = ReadlineBuilder.builder()
         .editMode(EditModeBuilder.builder()
                 .mode(EditMode.Mode.VI)
-                .create())
+                .build())
         .build();
 ```
 

content/docs/readline/prompt.md

@@ -83,15 +83,17 @@ Prompt prompt = new Prompt(parts);
 
 ## Methods
 
-### getPromptAsString()
+### getPromptCharacters()
 
 Returns the prompt text without ANSI codes:
 
 ```java
 Prompt prompt = new Prompt("[user]$ ");
-String text = prompt.getPromptAsString(); // "[user]$ "
+String text = prompt.getPromptCharacters(); // "[user]$ "
 ```
 
+> **Note:** `getPromptAsString()` is deprecated — use `getPromptCharacters()` instead.
+
 ### getMask()
 
 Returns the mask character, or `null` if no masking:
@@ -128,6 +130,49 @@ Prompt original = new Prompt("$ ");
 Prompt copy = original.copy();
 ```
 
+## Prompt Builder
+
+`Prompt.builder()` provides a fluent API for constructing prompts, as an alternative to the telescoping constructors:
+
+```java
+// Simple text prompt
+Prompt prompt = Prompt.builder()
+        .message("$ ")
+        .build();
+
+// Password prompt with mask
+Prompt prompt = Prompt.builder()
+        .message("Password: ")
+        .mask('*')
+        .build();
+
+// Styled prompt with TerminalString
+Prompt prompt = Prompt.builder()
+        .terminalString(new TerminalString("[admin]# ",
+                new TerminalColor(Color.RED, Color.DEFAULT),
+                CharacterType.BOLD))
+        .build();
+
+// Prompt with ANSI string
+Prompt prompt = Prompt.builder()
+        .message("$ ")
+        .ansi("\u001B[32m$ \u001B[0m")
+        .build();
+```
+
+### Builder Methods
+
+| Method | Type | Description |
+|--------|------|-------------|
+| `message(String)` | `String` | Set the prompt text |
+| `ansi(String)` | `String` | Set the ANSI-formatted display string |
+| `mask(char)` | `char` | Set mask character for hidden input |
+| `promptCodePoints(int[])` | `int[]` | Set prompt as Unicode code points |
+| `terminalString(TerminalString)` | `TerminalString` | Set a styled prompt |
+| `characters(List<TerminalCharacter>)` | `List` | Set individually formatted characters |
+
+When multiple sources are set, the builder uses this precedence (highest first): `characters`, `terminalString`, `promptCodePoints`, `message`.
+
 ## Using Prompts
 
 ### With Readline

content/docs/readline/readline-api.md

@@ -51,7 +51,7 @@ Readline readline = ReadlineBuilder.builder().build();
 Readline readline = ReadlineBuilder.builder()
         .editMode(EditModeBuilder.builder()
                 .mode(EditMode.Mode.EMACS)
-                .create())
+                .build())
         .history(new FileHistory(new File(".history"), 500, true))
         .enableHistory(true)
         .historySize(1000)
@@ -204,6 +204,61 @@ readline.readline(connection, prompt, handler, completions,
         preProcessors, history, listener, flags);
 ```
 
+### ReadlineFlags Helper
+
+The `ReadlineFlags` utility class provides a concise way to create flag sets without manual `EnumMap` construction:
+
+```java
+import org.aesh.readline.ReadlineFlags;
+
+// No flags
+ReadlineFlags.none();
+
+// Specific flags
+ReadlineFlags.of(ReadlineFlag.NO_SYNCHRONIZED_OUTPUT);
+ReadlineFlags.of(ReadlineFlag.NO_CLIPBOARD, ReadlineFlag.NO_SHELL_INTEGRATION);
+
+// All flags
+ReadlineFlags.all();
+```
+
+> **Note:** `ReadlineFlags` produces `EnumSet<ReadlineFlag>` values. These are accepted by the `ReadlineRequest` builder's `flags()` method and the `readline()` overloads.
+
+### ReadlineRequest Builder
+
+For calls that use several optional parameters, `ReadlineRequest` provides a builder pattern that avoids passing `null` for unused fields:
+
+```java
+import org.aesh.readline.ReadlineRequest;
+
+ReadlineRequest request = ReadlineRequest.builder()
+        .connection(connection)
+        .prompt(new Prompt("$ "))
+        .requestHandler(input -> processInput(input))
+        .completions(myCompletions)
+        .history(customHistory)
+        .cursorListener(listener)
+        .build();
+
+readline.readline(request);
+```
+
+**Required fields:** `connection`, `prompt`, `requestHandler`.
+
+| Builder Method | Type | Description |
+|----------------|------|-------------|
+| `connection(Connection)` | `Connection` | Terminal connection (required) |
+| `prompt(Prompt)` | `Prompt` | Prompt to display (required) |
+| `prompt(String)` | `String` | Prompt string (convenience, creates a Prompt) |
+| `requestHandler(Consumer<String>)` | `Consumer` | Input handler callback (required) |
+| `completions(List<Completion>)` | `List` | Tab completions |
+| `preProcessors(List<Function<String, Optional<String>>>)` | `List` | Input transformers |
+| `history(History)` | `History` | Custom history for this read |
+| `cursorListener(CursorListener)` | `CursorListener` | Cursor movement events |
+| `flags(EnumMap<ReadlineFlag, Integer>)` | `EnumMap` | Behavior flags |
+
+> **Note:** The existing `readline()` overloads with positional parameters are deprecated in favor of `ReadlineRequest`. They continue to work but new code should prefer the builder.
+
 ## Completion
 
 ### Completion Class
@@ -378,7 +433,7 @@ public enum Mode {
 ```java
 EditMode editMode = EditModeBuilder.builder()
         .mode(EditMode.Mode.EMACS)
-        .create();
+        .build();
 
 Readline readline = ReadlineBuilder.builder()
         .editMode(editMode)
@@ -478,7 +533,7 @@ public class InteractiveShell {
         this.readline = ReadlineBuilder.builder()
                 .editMode(EditModeBuilder.builder()
                         .mode(EditMode.Mode.EMACS)
-                        .create())
+                        .build())
                 .history(new FileHistory(new File(".myshell_history"), 1000, true))
                 .enableHistory(true)
                 .historySize(1000)

content/docs/readline/synchronized-output.md

@@ -140,6 +140,20 @@ readline.readline(connection, new Prompt("$ "), input -> {
 }, null, null, null, null, flags);
 ```
 
+Or more concisely with `ReadlineRequest` and `ReadlineFlags`:
+
+```java
+import org.aesh.readline.ReadlineRequest;
+import org.aesh.readline.ReadlineFlags;
+
+readline.readline(ReadlineRequest.builder()
+        .connection(connection)
+        .prompt("$ ")
+        .requestHandler(input -> { /* handle input */ })
+        .flags(ReadlineFlags.of(ReadlineFlag.NO_SYNCHRONIZED_OUTPUT))
+        .build());
+```
+
 ## Manual Usage
 
 For applications that manage their own rendering loop (outside of `Readline`), use