inline-chat-kit 0.59.0 → 0.60.0

package/CHANGELOG.md

@@ -8,6 +8,150 @@ The versions before 1.0 follow the pre-release convention: **a breaking change
 or new public API bumps the minor**, and the patch is for fixes. Anything that would break an
 existing install is called out under **Breaking**, with what to do about it.
 
+## 0.60.0 — 2026-10-15
+
+Reported from a host running the kit in production, each one worked around
+outside the kit there. Each was reproduced here before it was changed.
+
+### Fixed
+
+- **The header's "…" menu closes when "…" is pressed again.** The press
+  moved focus from the menu to the button, the menu closed on that blur, and
+  the click toggled it straight back open. Measured in Chromium and WebKit, by
+  mouse and by touch: it could not be closed that way at all.
+- **And on a press anywhere outside it.** It closed only on a blur, and on iOS
+  a tap on something that takes no focus moves none — so the menu stayed open
+  over whatever was touched next.
+- **`ChatExperience` fits its container on a page with no `box-sizing`
+  reset.** It was `width: 100%` plus 64px of padding, so in a 400px side
+  panel the end of every sent message sat under the panel's edge. A host
+  with a reset saw nothing change; one without now gets the column the
+  playground was designed with — 720px overall, not 784.
+- **A short message is no longer faded, with "Read more" on it, because of
+  the width it had for one frame.** Whether a sent message is long was
+  measured once, a frame after the answer settled. In a host's side panel
+  still opening under an instant answer, that frame had the bubble 27px wide:
+  a one-line message measured 269px tall and stayed faded at 201×25. It is
+  measured again whenever it reflows, and the fade and the button go when it
+  is no longer long. A resting message mounted from history is measured too,
+  so it is clamped the same way a freshly sent one is.
+- **An empty composer is never two lines.** Mounted a few pixels wide in the
+  same panel, the fresh composer decided it needed a second line, and the way
+  back compared against that width, so it never returned: 68px tall, its "+"
+  on a line of its own, for the rest of the session.
+- **A docked composer no longer jumps on a send.** The fresh composer arrived
+  like any new turn — rising 16px into place — so the box at the bottom went
+  up and back every time a message was sent (840 → 824 → 840). It fades in
+  where it is now. A sent message still goes to the top, as before.
+- **Docked, the question lands before its answer starts.** The answer's "…"
+  appeared at the top the moment a message was sent, while the message was
+  still travelling up from the composer — two things moving in opposite
+  directions, an answer begun above a question that had not arrived. The
+  answer now waits, still taking its room so the anchor does not move, until
+  the bubble has stopped: about 0.45s, measured at 1120×700 and 390×844, and
+  for a model that is silent first. Read off the screen rather than from the
+  spring, which rests at 1.2s, and including the scroll that carries a second
+  message most of its way. `ChatTurnRow` takes it as `answerAfterTravel`;
+  `ChatInput` reports it through `onLanded`.
+
+### Added
+
+- **`ChatTurnRow` takes `entrance`** — `"rise"` or `"fade"`.
+- **A host's own buttons.** A host matched the kit's buttons by hashed class
+  name (`[class*='ick-primary-']`), by position (the button in the
+  composer's surface is the send) and by `aria-label` (the stop is the one
+  labelled "Zaustavi"), so translating a label changed its colour.
+  - Every variant is painted from `--ick-btn-<variant>-*` tokens, with
+    `--ick-btn-radius` and `--ick-btn-weight`. The defaults are the values
+    the variants had: compared in both themes, at rest and on hover, 60
+    samples, no difference.
+  - Every button the kit draws says what it is for in `data-ick-role` and
+    what it is in `data-ick-variant`. `send`, `stop` and `save` are three
+    roles, not one button with three labels. A test fails on a `<Button>`
+    drawn without a role.
+  - `ChatHeaderAction` takes `variant`, so one action can be the host's
+    primary.
+  - `HostButtons` story; the tokens and the roles are listed in
+    `theming.md`.
+
+  Not a `components={{ Button }}` slot, though that was asked for: the kit's
+  buttons carry the composer's morphing glyph and its layout animation, and
+  a host component would have to take all of it on to stand in for one.
+- **`OpensWithTheMessage` story**, and `npm run panel-check` in the gate: a
+  card's button opens a side panel and sends from it, the answer is ready at
+  once. Four failures against 0.59.2, none now — and a long message is
+  checked to still be clamped.
+
+## 0.59.2 — 2026-09-24
+
+### Fixed
+
+Docked, an answer holds still while it arrives and as it finishes. Measured
+after the frame is painted, in four windows, on every answer the demo gives:
+from 6 failures to none.
+
+- **An answer with a card in it no longer drops and comes back as it
+  settles.** The room under the last turn was a margin written a frame after
+  the answer changed. When anything inside the turn got shorter — the
+  reasoning folding away as a card arrived — the scroll was clamped before
+  the margin caught up, and the whole answer dropped 3–13px for a frame. The
+  room is now the last turn's `min-height`, which the browser holds in the
+  same layout.
+- **A finished answer is no longer nudged up.** Its row of actions was drawn
+  only on settling, 36px of new height at the moment it finished, and an
+  answer near the composer was pushed up by what did not fit — 2px, or 25.
+  The row is now there, hidden, while the answer arrives.
+- **Following the end of a long answer keeps the last line above the
+  composer**, where it went 13px behind it. And when a settled answer does
+  have to move, it glides once to where it ends up instead of travelling to
+  where the end was and creeping back.
+- **An artifact card grows to its content** instead of jumping from 97px to
+  236px in a frame and throwing the answer under it down.
+- **Inline, the sent bubble no longer flickers between one line and two**
+  as its stop leaves: the exit spring overshot zero by a fraction of a pixel,
+  enough to wrap, four times in 40ms. It is critically damped now.
+- **Browser scroll anchoring is off in the conversation** — the component
+  places the view, and Safari never anchored.
+
+### Added
+
+- `npm run still-check` in the gate: no jolt (3px undone within two frames),
+  and an answer that fits is not moved as it settles.
+
+### Known
+
+- Inline, the room is still the measured margin, and a reasoning folding
+  away can still clamp the view for a frame by 3–4px, as it did before.
+
+## 0.59.1 — 2026-09-24
+
+### Fixed
+
+- **A sent message goes to the top while the model is still silent.** It
+  waited for the answer: a model that thinks for a few seconds and then
+  answers all at once left the message where it was sent until the answer
+  came. Two causes, either one enough:
+  - **A host's chat published a render late.** A host that keeps its
+    `useChatTurns` in a store and publishes it from an effect hands the kit the
+    turns a render after the press. For that render the turn is still the
+    composer, and docked the composer is on the bottom edge — the anchor moved
+    the view there and was spent. The anchor now waits for the turn to have
+    been sent. Measured before: 399px in a 900px window, 526px in an 844px one.
+  - **The room under a docked conversation came up short.** While the
+    conversation is shorter than the view, the dock's `margin-top: auto`
+    swallows the first of the room, and the correction came a frame after the
+    view had set off for the old end — and the view no longer looked. The room
+    is now settled in one pass, and a travel that was overtaken is looked at
+    again when it lands. Measured before: the second message stopped at 141px
+    in a 680px window.
+
+### Added
+
+- **`ThinksFirst` and `ChatInAStore` stories**, and `npm run silent-check`
+  in the gate: three messages to a model silent for 2.5s, in three windows,
+  each at the anchor 700ms after the send and still there at 2300ms. Without
+  either fix it fails seven of eighteen.
+
 ## 0.59.0 — 2026-09-24
 
 From integrating 0.58 into a host app. Nothing changes for a host that passes

package/README.md

@@ -211,6 +211,8 @@ input that morphs into its own bubble rather than a record of what was typed.
 | `placeholder` | `string` | | |
 | `animationConfig` | `InlineAnimConfig` | | Passed to the input |
 | `entranceDelay` | `number` | `0` | Stagger, in seconds |
+| `entrance` | `"rise" \| "fade"` | `"rise"` | How the row arrives — a docked composer fades in place |
+| `answerAfterTravel` | `boolean` | `false` | The answer waits until the sent question has landed — docked, set by `ChatExperience` |
 | `selectionMode` | `"marker" \| "precise"` | `"marker"` | Passed to the highlighter |
 | `questionAlign` | `"end" \| "stretch"` | `"end"` | Where the composer sits — see below |
 | `onDraft` | `(id, value) => void` | | |
@@ -1393,7 +1395,9 @@ handful of things you can do to the whole thread.
 | `landmark` | `boolean` | `true` | `false` inside a panel, where `banner` would be a lie |
 | `children` | `ReactNode` | | Anything the kit should not manage. Never collapses |
 
-Each action is `{ id, label, icon, onClick?, href?, count?, active?, disabled?, pinned? }`.
+Each action is `{ id, label, icon, onClick?, href?, count?, active?, disabled?, pinned?, variant? }`.
+`variant` is how one action stands out — `"primary"` for the host's own — and
+only applies while it is in the header rather than folded into the menu.
 `label` is required because an icon has no name of its own, and `count` is
 folded into that name — the badge is decorative, so a reader who cannot see it
 still hears "Saved highlights, 3".