@@ -18,7 +18,8 @@ All props accepted by `VStack` and `HStack`:
1818 overflow, // "hidden" (default) | "scroll"
1919 scrollbar, // boolean
2020 scrollOffset, // number (controlled scroll)
21- onScroll, // (offset: number) => void
21+ onScroll, // (offset: number, maxOffset: number) => void
22+ flexWrap, // "nowrap" (default) | "wrap" (HStack only)
2223
2324 // Styling (inherited by descendants)
2425 bold, italic, underline,// boolean
@@ -49,7 +50,7 @@ VStack(
4950 overflow: "scroll",
5051 scrollbar: true,
5152 scrollOffset: offset,
52- onScroll: (newOffset) => {
53+ onScroll: (newOffset, maxOffset) => {
5354 offset = newOffset;
5455 cel.render();
5556 },
@@ -60,7 +61,7 @@ VStack(
6061
6162 - Scroll direction follows the container’s main axis: VStack → vertical, HStack → horizontal.
6263 - Scroll is pointer-driven (mouse wheel), not focus-driven. A user can type in a focused widget while scrolling a different container.
63-- In controlled mode, the UI only moves when the app passes the updated `scrollOffset` back. `onScroll` fires with the clamped new offset.
64+- In controlled mode, the UI only moves when the app passes the updated `scrollOffset` back. `onScroll` fires with the clamped new offset and the maximum offset (content size minus viewport size). Pass `Infinity` as `scrollOffset` to mean "scroll to end" (clamped during rendering).
6465
6566 ## Text Props
6667
@@ -122,9 +123,10 @@ Divider(); // Text("─", { repeat: "fill" })
122123 Divider({ char: "═", fgColor: "color08" });
123124 Button("[OK]", { onClick: handleOk });
124125 Button("✕", { onClick: handleClose, focusable: false });
125-// Button accepts: onClick, bold, fgColor, bgColor, focusable, focusStyle
126-// Note: Button does not forward container sizing props.
127-// For full control, use HStack + Text directly.
126+// Button accepts: onClick, focusable, focused, onFocus, onBlur, focusStyle,
127+// onKeyPress, padding, bold, fgColor, bgColor, italic, underline.
128+// Note: Button does not forward container sizing props (width, height, flex).
129+// For full layout control, use HStack + Text directly.
128130 ```
129131
130132 ### Select (filterable list)
@@ -180,3 +182,77 @@ const modelSelect = Select({
180182 },
181183 });
182184 ```
185+
186+### VDivider (vertical divider)
187+
188+```ts
189+import { VDivider } from "@cel-tui/components";
190+
191+// Separate columns in an HStack
192+HStack({ height: "100%" }, [
193+ VStack({ flex: 1 }, [Text("left pane")]),
194+ VDivider({ fgColor: "color08" }),
195+ VStack({ flex: 1 }, [Text("right pane")]),
196+]);
197+
198+// Custom character
199+VDivider({ char: "║", fgColor: "color08" });
200+```
201+
202+### Markdown (rendered markdown)
203+
204+Returns an array of nodes — spread into a container's children:
205+
206+````ts
207+import { Markdown } from "@cel-tui/components";
208+
209+VStack(
210+ { flex: 1, overflow: "scroll", padding: { x: 1 } },
211+ Markdown("# Hello\n\nSome **bold** text.\n\n```js\nconst x = 1;\n```"),
212+);
213+````
214+
215+Custom theme for markdown styling:
216+
217+```ts
218+Markdown(content, {
219+ theme: {
220+ heading1: { bold: true, fgColor: "color05" },
221+ codeBlock: { bgColor: "color08" },
222+ bold: { bold: true, fgColor: "color03" },
223+ },
224+});
225+```
226+
227+Streaming works naturally — append chunks and call `cel.render()`. Unclosed blocks are handled gracefully.
228+
229+## Theme
230+
231+The default theme maps 16 color slots to ANSI palette indices. Custom themes remap to 256-color or 24-bit hex:
232+
233+```ts
234+import { cel, ProcessTerminal, type Theme } from "@cel-tui/core";
235+
236+const mocha: Theme = {
237+ color00: "#1e1e2e",
238+ color01: "#f38ba8",
239+ color02: "#a6e3a1",
240+ color03: "#f9e2af",
241+ color04: "#89b4fa",
242+ color05: "#cba6f7",
243+ color06: "#94e2d5",
244+ color07: "#cdd6f4",
245+ color08: "#45475a",
246+ color09: "#f38ba8",
247+ color10: "#a6e3a1",
248+ color11: "#f9e2af",
249+ color12: "#89b4fa",
250+ color13: "#cba6f7",
251+ color14: "#94e2d5",
252+ color15: "#bac2de",
253+};
254+
255+cel.init(new ProcessTerminal(), { theme: mocha });
256+```
257+
258+App code uses `"color00"`–`"color15"` regardless of theme. The mapping is a rendering concern.