@iyulab/chat-components 0.11.8 → 0.12.0

package/skills/iyulab-chat-components/references/components/marked-block.md

@@ -35,6 +35,14 @@ Tracks a `streaming` state internally (resets a 1500ms idle timer on every `valu
 
 ---
 
+## Sizing
+
+The block grows with its content — there is no cap, and the conversation around it does the
+scrolling.
+
+**Fenced code becomes a nested [`u-code-block`](code-block.md)**, not a plain `<pre>`, so fenced
+code follows that component's contract (no vertical cap; long lines scroll horizontally).
+
 ## Properties
 
 | Property | Type | Default | Description |

package/skills/iyulab-chat-components/references/components/message.md

@@ -36,6 +36,14 @@ Chat message wrapper component. Arranges content blocks via slots, shows a loadi
 
 ---
 
+## Sizing
+
+Content-sized: the bubble is as tall as what you put in it.
+
+⚠**A `max-height` on the host does *not* fold the content, and that is deliberate.** A message that
+hides part of itself cannot be read, and the conversation stream around it already scrolls. The
+block overflows **visibly** rather than clipping. Constrain the stream, not the message.
+
 ## Slots
 
 | Name | Description |

package/skills/iyulab-chat-components/references/components/prompt.md

@@ -47,6 +47,17 @@ prompt.submit();
 
 ---
 
+## Sizing
+
+The prompt does not grow with its value. `minRows`/`maxRows` bound the inner `u-text-block`, and the
+text scrolls **inside** that box — so the component stays short no matter how long the value is.
+Measured at 600px wide with a 40-line value and `maxRows: 40`, the whole block is 72px tall.
+
+⚠**Its behaviour under a host `max-height` is therefore untested.** A 200px or 120px constraint never
+engages, because the natural height is already below both. That is not the same as "it behaves
+correctly under a constraint" — it means the question has not been answered. Use `minRows`/`maxRows`
+to size this component.
+
 ## Slots
 
 | Name | Description |

package/skills/iyulab-chat-components/references/components/table-block.md

@@ -37,6 +37,21 @@ Extends `UDataElement`, so data can also be injected via a `<script type="applic
 
 ---
 
+## Sizing
+
+The table area caps at **480px** and scrolls inside that cap; below it the block is content-sized.
+Measured at 600px wide: 40 rows give a 480px table area with ~1,000px to scroll, 2 rows give ~108px
+and no scrollbar. That default keeps a long table from swallowing the conversation.
+
+**A `max-height` (or `height`) on the host wins.** The table area shrinks to fit it and still
+scrolls, so no rows become unreachable:
+
+```css
+u-table-block { max-height: 200px; }
+```
+
+There is no size property or custom property for this — the host is the lever.
+
 ## Properties
 
 | Property | Type | Default | Description |

package/skills/iyulab-chat-components/references/components/video-block.md

@@ -38,6 +38,16 @@ LLM output example (`block-json` code fence, rendered via `u-element-block`):
 
 ---
 
+## Sizing
+
+Height comes from width through `ratio` (`16:9` by default), capped at `max-width: 800px`. Measured
+at 600px wide, a 16:9 video is ~342px tall. This holds for both branches — the embed iframe
+(YouTube/Vimeo) and the native `<video>` element.
+
+⚠**A `max-height` on the host does *not* shrink the video, and that is deliberate** — the same
+reason as the image block: vertical squeezing would break the aspect ratio. The block overflows
+**visibly** rather than clipping. Use `ratio`, or a narrower column, to change its height.
+
 ## Properties
 
 | Property | Type | Default | Description |