@adea-ai/ui 0.67.0 → 0.67.2

package/README.md

@@ -180,9 +180,14 @@ transcript when its jump control disappears; automatic pins never move focus.
 
 `threshold` controls jump-button visibility (80px by default), independently of
 follow intent. `follow={false}` is fully inert: positioning belongs to the host,
-with no observer or mount pin. Re-enabling it explicitly re-arms at the bottom;
-it is not an automatic restore-and-resume flag. An optional `resetKey` also
-re-arms follow when that identity changes. Canonical
+with no observer or mount pin. Re-enabling it explicitly re-arms at the bottom
+unless the host supplies `initialReadingPosition: { top, following }`. That
+snapshot is consumed only on mount, identity reset or follow re-enable; ordinary
+snapshot prop changes never reposition the reader. A parked snapshot releases
+follow until an explicit jump or native return to the bottom. The
+`onReadingPositionChange` callback reports native offset and actual follow intent,
+including small upward moves inside the jump visibility threshold. An optional
+`resetKey` resets follow or consumes the current identity's snapshot. Canonical
 session identity, durable restoration and virtualized transcript windows remain
 application-owned. `ref` and `onScroll` still reach the inner scroller.
 

package/dist/components/conversation/conversation-surface.d.ts

@@ -15,6 +15,10 @@ import type { ComponentProps, JSX } from 'solid-js';
  *     than dragging the pane behind it — which in a desktop shell means the whole
  *     window moves.
  */
+export type ConversationReadingPosition = Readonly<{
+    top: number;
+    following: boolean;
+}>;
 export type ConversationSurfaceProps = ComponentProps<'div'> & {
     /** How far from the bottom still counts as "at the bottom", in px. */
     threshold?: number;
@@ -22,6 +26,10 @@ export type ConversationSurfaceProps = ComponentProps<'div'> & {
     follow?: boolean;
     /** Optional conversation identity: changing it re-arms follow at the bottom. */
     resetKey?: string;
+    /** Host snapshot consumed on mount/identity reset, never on ordinary prop updates. */
+    initialReadingPosition?: ConversationReadingPosition;
+    /** Actual follow intent and native offset; storage/identity remain host-owned. */
+    onReadingPositionChange?: (position: ConversationReadingPosition) => void;
     /** Rendered above the transcript when there is nothing in it. */
     empty?: JSX.Element;
     /** A header that scrolls with the transcript, e.g. a day divider or a banner. */

package/dist/components/conversation/conversation-surface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-surface.d.ts","sourceRoot":"","sources":["../../../src/components/conversation/conversation-surface.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAMnD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,wBAAwB,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG;IAC7D,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iEAAiE;IACjE,KAAK,CAAC,EAAE,GAAG,CAAC,OAAO,CAAA;IACnB,iFAAiF;IACjF,MAAM,CAAC,EAAE,GAAG,CAAC,OAAO,CAAA;CACrB,CAAA;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,eAmElE"}
+{"version":3,"file":"conversation-surface.d.ts","sourceRoot":"","sources":["../../../src/components/conversation/conversation-surface.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAMnD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,2BAA2B,GAAG,QAAQ,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,CAAA;AAEvF,MAAM,MAAM,wBAAwB,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG;IAC7D,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,sFAAsF;IACtF,sBAAsB,CAAC,EAAE,2BAA2B,CAAA;IACpD,kFAAkF;IAClF,uBAAuB,CAAC,EAAE,CAAC,QAAQ,EAAE,2BAA2B,KAAK,IAAI,CAAA;IACzE,iEAAiE;IACjE,KAAK,CAAC,EAAE,GAAG,CAAC,OAAO,CAAA;IACnB,iFAAiF;IACjF,MAAM,CAAC,EAAE,GAAG,CAAC,OAAO,CAAA;CACrB,CAAA;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,eAuElE"}

package/dist/components/conversation/conversation-surface.js

@@ -14,6 +14,8 @@ function ConversationSurface(props) {
 		"threshold",
 		"follow",
 		"resetKey",
+		"initialReadingPosition",
+		"onReadingPositionChange",
 		"empty",
 		"header",
 		"children",
@@ -24,7 +26,9 @@ function ConversationSurface(props) {
 	const follow = createScrollFollow({
 		enabled: () => local.follow !== false,
 		resetKey: () => local.resetKey,
-		threshold: () => local.threshold ?? 80
+		threshold: () => local.threshold ?? 80,
+		initialPosition: () => local.initialReadingPosition,
+		onPositionChange: (position) => local.onReadingPositionChange?.(position)
 	});
 	const onScroll = (event) => {
 		follow.onScroll();

package/dist/components/conversation/conversation-surface.js.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-surface.js","names":["ArrowDown","ComponentProps","JSX","Show","splitProps","cn","Button","createScrollFollow","ConversationSurfaceProps","threshold","follow","resetKey","empty","Element","header","ConversationSurface","props","local","rest","enabled","onScroll","EventHandlerUnion","HTMLDivElement","Event","event","handler","_el$","_tmpl$2","_el$2","firstChild","_el$3","addEventListener","_$use","element","bindScroller","ref","_$spread","_$mergeProps","tabindex","_ref$","bindContent","_$insert","_$createComponent","when","children","fallback","_el$5","_tmpl$3","atBottom","_el$4","_tmpl$","type","size","variant","onClick","jump","_$effect","_$className","class","_$mergeProps","_$use","_$createComponent","_$className"],"sources":["../../../src/components/conversation/conversation-surface.tsx"],"sourcesContent":["import { ArrowDown } from 'lucide-solid'\nimport type { ComponentProps, JSX } from 'solid-js'\nimport { Show, splitProps } from 'solid-js'\nimport { cn } from '#lib/utils'\nimport { Button } from '../ui/button/button'\nimport { createScrollFollow } from './scroll-follow'\n\n/**\n * ConversationSurface.\n *\n * The scrolling transcript. Its job is small and it is the difference between a\n * transcript that stays readable as it grows and one that fights the reader:\n *\n *   - **Stick to the bottom.** New messages scroll into view only when the reader is\n *     already at the bottom. Someone reading back through history must not be yanked\n *     to the end by an arriving message, and that is the single most common way a\n *     chat surface is made unusable.\n *   - **Offer a way back.** Once the reader is not at the bottom, a control appears\n *     that returns them. Pixel distance cannot prove an unread message count.\n *   - **`overscroll-contain`.** The transcript scrolls to its end and stops, rather\n *     than dragging the pane behind it — which in a desktop shell means the whole\n *     window moves.\n */\nexport type ConversationSurfaceProps = ComponentProps<'div'> & {\n  /** How far from the bottom still counts as \"at the bottom\", in px. */\n  threshold?: number\n  /** Disable automatic positioning while the host owns scroll restoration. */\n  follow?: boolean\n  /** Optional conversation identity: changing it re-arms follow at the bottom. */\n  resetKey?: string\n  /** Rendered above the transcript when there is nothing in it. */\n  empty?: JSX.Element\n  /** A header that scrolls with the transcript, e.g. a day divider or a banner. */\n  header?: JSX.Element\n}\n\nexport function ConversationSurface(props: ConversationSurfaceProps) {\n  const [local, rest] = splitProps(props, [\n    'class',\n    'threshold',\n    'follow',\n    'resetKey',\n    'empty',\n    'header',\n    'children',\n    'onScroll',\n    'ref',\n    'tabindex',\n  ])\n  // Kobalte provides the control's semantics; transcript follow is a native\n  // geometry contract. KiroCrew's plain-scroller controller handles streaming,\n  // content collapse and pane resizing without treating them as user consent.\n  const follow = createScrollFollow({\n    enabled: () => local.follow !== false,\n    resetKey: () => local.resetKey,\n    threshold: () => local.threshold ?? 80,\n  })\n  const onScroll: JSX.EventHandlerUnion<HTMLDivElement, Event> = (event) => {\n    follow.onScroll()\n    const handler = local.onScroll\n    if (typeof handler === 'function') handler(event)\n    else if (handler) handler[0](handler[1], event)\n  }\n\n  return (\n    <div\n      data-slot=\"conversation-surface\"\n      class={cn('relative flex min-h-0 flex-1 flex-col', local.class)}\n    >\n      <div\n        ref={(element) => {\n          follow.bindScroller(element)\n          if (typeof local.ref === 'function') local.ref(element)\n        }}\n        onScroll={onScroll}\n        tabindex={local.tabindex ?? 0}\n        class=\"min-h-0 flex-1 overflow-y-auto overscroll-contain\"\n        {...rest}\n      >\n        <div ref={follow.bindContent} data-slot=\"conversation-content\">\n          <Show when={local.header}>{local.header}</Show>\n          <Show when={local.children} fallback={<div class=\"p-4\">{local.empty}</div>}>\n            {local.children}\n          </Show>\n        </div>\n      </div>\n\n      <Show when={!follow.atBottom()}>\n        <div class=\"pointer-events-none absolute inset-x-0 bottom-3 flex justify-center\">\n          <Button\n            type=\"button\"\n            size=\"sm\"\n            variant=\"secondary\"\n            class=\"pointer-events-auto gap-1.5 shadow-md\"\n            onClick={follow.jump}\n          >\n            <ArrowDown />\n            Jump to latest\n          </Button>\n        </div>\n      </Show>\n    </div>\n  )\n}\n"],"mappings":";;;;;;;;;;AAoCA,SAAgBe,oBAAoBC,OAAiC;CACnE,MAAM,CAACC,OAAOC,QAAQd,WAAWY,OAAO;EACtC;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CAAU,CACX;CAID,MAAMN,SAASH,mBAAmB;EAChCY,eAAeF,MAAMP,WAAW;EAChCC,gBAAgBM,MAAMN;EACtBF,iBAAiBQ,MAAMR,aAAa;CACtC,CAAC;CACD,MAAMW,YAA0DI,UAAU;EACxEd,OAAOU,SAAS;EAChB,MAAMK,UAAUR,MAAMG;EACtB,IAAI,OAAOK,YAAY,YAAYA,QAAQD,KAAK;OAC3C,IAAIC,SAASA,QAAQ,EAAE,CAACA,QAAQ,IAAID,KAAK;CAChD;CAEA,cAAA;EAAA,IAAAE,OAAAC,QAAA,GAAAC,QAAAF,KAAAG,YAAAC,QAAAF,MAAAC;EAAAD,MAAAG,iBAAA,UAUgBX,QAAQ;EAAAY,KAJZC,YAAY;GAChBvB,OAAOwB,aAAaD,OAAO;GAC3B,IAAI,OAAOhB,MAAMkB,QAAQ,YAAYlB,MAAMkB,IAAIF,OAAO;EACxD,GAACL,KAAA;EAAAQ,OAAAR,OAAAS,WAAA,EAAA,IAEDC,WAAQ;GAAA,OAAErB,MAAMqB,YAAY;EAAC,EAAA,GAEzBpB,IAAI,GAAA,OAAA,IAAA;EAAA,IAAAqB,QAEE7B,OAAO8B;EAAW,OAAAD,UAAA,aAAAP,IAAAO,OAAAT,KAAA,IAAlBpB,OAAO8B,cAAWV;EAAAW,OAAAX,OAAAY,gBACzBvC,MAAI;GAAA,IAACwC,OAAI;IAAA,OAAE1B,MAAMH;GAAM;GAAA,IAAA8B,WAAA;IAAA,OAAG3B,MAAMH;GAAM;EAAA,CAAA,GAAA,IAAA;EAAA2B,OAAAX,OAAAY,gBACtCvC,MAAI;GAAA,IAACwC,OAAI;IAAA,OAAE1B,MAAM2B;GAAQ;GAAA,IAAEC,WAAQ;IAAA,cAAA;KAAA,IAAAC,QAAAC,QAAA;KAAAN,OAAAK,aAAoB7B,MAAML,KAAK;KAAA,OAAAkC;IAAA,EAAA,CAAA;GAAA;GAAA,IAAAF,WAAA;IAAA,OAChE3B,MAAM2B;GAAQ;EAAA,CAAA,GAAA,IAAA;EAAAH,OAAAf,MAAAgB,gBAKpBvC,MAAI;GAAA,IAACwC,OAAI;IAAA,OAAE,CAACjC,OAAOsC,SAAS;GAAC;GAAA,IAAAJ,WAAA;IAAA,IAAAK,QAAAC,OAAA;IAAAT,OAAAQ,OAAAP,gBAEzBpC,QAAM;KACL6C,MAAI;KACJC,MAAI;KACJC,SAAO;KAAA,SAAA;KAAA,IAEPC,UAAO;MAAA,OAAE5C,OAAO6C;KAAI;KAAA,IAAAX,WAAA;MAAA,OAAA,CAAAF,gBAEnB1C,WAAS,CAAA,CAAA,GAAA,gBAAA;KAAA;IAAA,CAAA,CAAA;IAAA,OAAAiD;GAAA;EAAA,CAAA,GAAA,IAAA;EAAAO,aAAAC,UAAA/B,MA7BTrB,GAAG,yCAAyCY,MAAMyC,KAAK,CAAC,CAAA;EAAA,OAAAhC;CAAA,EAAA,CAAA;AAoCrE"}
+{"version":3,"file":"conversation-surface.js","names":["ArrowDown","ComponentProps","JSX","Show","splitProps","cn","Button","createScrollFollow","ConversationReadingPosition","Readonly","top","following","ConversationSurfaceProps","threshold","follow","resetKey","initialReadingPosition","onReadingPositionChange","position","empty","Element","header","ConversationSurface","props","local","rest","enabled","initialPosition","onPositionChange","onScroll","EventHandlerUnion","HTMLDivElement","Event","event","handler","_el$","_tmpl$2","_el$2","firstChild","_el$3","addEventListener","_$use","element","bindScroller","ref","_$spread","_$mergeProps","tabindex","_ref$","bindContent","_$insert","_$createComponent","when","children","fallback","_el$5","_tmpl$3","atBottom","_el$4","_tmpl$","type","size","variant","onClick","jump","_$effect","_$className","class","_$mergeProps","_$use","_$createComponent","_$className"],"sources":["../../../src/components/conversation/conversation-surface.tsx"],"sourcesContent":["import { ArrowDown } from 'lucide-solid'\nimport type { ComponentProps, JSX } from 'solid-js'\nimport { Show, splitProps } from 'solid-js'\nimport { cn } from '#lib/utils'\nimport { Button } from '../ui/button/button'\nimport { createScrollFollow } from './scroll-follow'\n\n/**\n * ConversationSurface.\n *\n * The scrolling transcript. Its job is small and it is the difference between a\n * transcript that stays readable as it grows and one that fights the reader:\n *\n *   - **Stick to the bottom.** New messages scroll into view only when the reader is\n *     already at the bottom. Someone reading back through history must not be yanked\n *     to the end by an arriving message, and that is the single most common way a\n *     chat surface is made unusable.\n *   - **Offer a way back.** Once the reader is not at the bottom, a control appears\n *     that returns them. Pixel distance cannot prove an unread message count.\n *   - **`overscroll-contain`.** The transcript scrolls to its end and stops, rather\n *     than dragging the pane behind it — which in a desktop shell means the whole\n *     window moves.\n */\nexport type ConversationReadingPosition = Readonly<{ top: number; following: boolean }>\n\nexport type ConversationSurfaceProps = ComponentProps<'div'> & {\n  /** How far from the bottom still counts as \"at the bottom\", in px. */\n  threshold?: number\n  /** Disable automatic positioning while the host owns scroll restoration. */\n  follow?: boolean\n  /** Optional conversation identity: changing it re-arms follow at the bottom. */\n  resetKey?: string\n  /** Host snapshot consumed on mount/identity reset, never on ordinary prop updates. */\n  initialReadingPosition?: ConversationReadingPosition\n  /** Actual follow intent and native offset; storage/identity remain host-owned. */\n  onReadingPositionChange?: (position: ConversationReadingPosition) => void\n  /** Rendered above the transcript when there is nothing in it. */\n  empty?: JSX.Element\n  /** A header that scrolls with the transcript, e.g. a day divider or a banner. */\n  header?: JSX.Element\n}\n\nexport function ConversationSurface(props: ConversationSurfaceProps) {\n  const [local, rest] = splitProps(props, [\n    'class',\n    'threshold',\n    'follow',\n    'resetKey',\n    'initialReadingPosition',\n    'onReadingPositionChange',\n    'empty',\n    'header',\n    'children',\n    'onScroll',\n    'ref',\n    'tabindex',\n  ])\n  // Kobalte provides the control's semantics; transcript follow is a native\n  // geometry contract. KiroCrew's plain-scroller controller handles streaming,\n  // content collapse and pane resizing without treating them as user consent.\n  const follow = createScrollFollow({\n    enabled: () => local.follow !== false,\n    resetKey: () => local.resetKey,\n    threshold: () => local.threshold ?? 80,\n    initialPosition: () => local.initialReadingPosition,\n    onPositionChange: (position) => local.onReadingPositionChange?.(position),\n  })\n  const onScroll: JSX.EventHandlerUnion<HTMLDivElement, Event> = (event) => {\n    follow.onScroll()\n    const handler = local.onScroll\n    if (typeof handler === 'function') handler(event)\n    else if (handler) handler[0](handler[1], event)\n  }\n\n  return (\n    <div\n      data-slot=\"conversation-surface\"\n      class={cn('relative flex min-h-0 flex-1 flex-col', local.class)}\n    >\n      <div\n        ref={(element) => {\n          follow.bindScroller(element)\n          if (typeof local.ref === 'function') local.ref(element)\n        }}\n        onScroll={onScroll}\n        tabindex={local.tabindex ?? 0}\n        class=\"min-h-0 flex-1 overflow-y-auto overscroll-contain\"\n        {...rest}\n      >\n        <div ref={follow.bindContent} data-slot=\"conversation-content\">\n          <Show when={local.header}>{local.header}</Show>\n          <Show when={local.children} fallback={<div class=\"p-4\">{local.empty}</div>}>\n            {local.children}\n          </Show>\n        </div>\n      </div>\n\n      <Show when={!follow.atBottom()}>\n        <div class=\"pointer-events-none absolute inset-x-0 bottom-3 flex justify-center\">\n          <Button\n            type=\"button\"\n            size=\"sm\"\n            variant=\"secondary\"\n            class=\"pointer-events-auto gap-1.5 shadow-md\"\n            onClick={follow.jump}\n          >\n            <ArrowDown />\n            Jump to latest\n          </Button>\n        </div>\n      </Show>\n    </div>\n  )\n}\n"],"mappings":";;;;;;;;;;AA0CA,SAAgBsB,oBAAoBC,OAAiC;CACnE,MAAM,CAACC,OAAOC,QAAQrB,WAAWmB,OAAO;EACtC;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CAAU,CACX;CAID,MAAMT,SAASP,mBAAmB;EAChCmB,eAAeF,MAAMV,WAAW;EAChCC,gBAAgBS,MAAMT;EACtBF,iBAAiBW,MAAMX,aAAa;EACpCc,uBAAuBH,MAAMR;EAC7BY,mBAAmBV,aAAaM,MAAMP,0BAA0BC,QAAQ;CAC1E,CAAC;CACD,MAAMW,YAA0DI,UAAU;EACxEnB,OAAOe,SAAS;EAChB,MAAMK,UAAUV,MAAMK;EACtB,IAAI,OAAOK,YAAY,YAAYA,QAAQD,KAAK;OAC3C,IAAIC,SAASA,QAAQ,EAAE,CAACA,QAAQ,IAAID,KAAK;CAChD;CAEA,cAAA;EAAA,IAAAE,OAAAC,QAAA,GAAAC,QAAAF,KAAAG,YAAAC,QAAAF,MAAAC;EAAAD,MAAAG,iBAAA,UAUgBX,QAAQ;EAAAY,KAJZC,YAAY;GAChB5B,OAAO6B,aAAaD,OAAO;GAC3B,IAAI,OAAOlB,MAAMoB,QAAQ,YAAYpB,MAAMoB,IAAIF,OAAO;EACxD,GAACL,KAAA;EAAAQ,OAAAR,OAAAS,WAAA,EAAA,IAEDC,WAAQ;GAAA,OAAEvB,MAAMuB,YAAY;EAAC,EAAA,GAEzBtB,IAAI,GAAA,OAAA,IAAA;EAAA,IAAAuB,QAEElC,OAAOmC;EAAW,OAAAD,UAAA,aAAAP,IAAAO,OAAAT,KAAA,IAAlBzB,OAAOmC,cAAWV;EAAAW,OAAAX,OAAAY,gBACzBhD,MAAI;GAAA,IAACiD,OAAI;IAAA,OAAE5B,MAAMH;GAAM;GAAA,IAAAgC,WAAA;IAAA,OAAG7B,MAAMH;GAAM;EAAA,CAAA,GAAA,IAAA;EAAA6B,OAAAX,OAAAY,gBACtChD,MAAI;GAAA,IAACiD,OAAI;IAAA,OAAE5B,MAAM6B;GAAQ;GAAA,IAAEC,WAAQ;IAAA,cAAA;KAAA,IAAAC,QAAAC,QAAA;KAAAN,OAAAK,aAAoB/B,MAAML,KAAK;KAAA,OAAAoC;IAAA,EAAA,CAAA;GAAA;GAAA,IAAAF,WAAA;IAAA,OAChE7B,MAAM6B;GAAQ;EAAA,CAAA,GAAA,IAAA;EAAAH,OAAAf,MAAAgB,gBAKpBhD,MAAI;GAAA,IAACiD,OAAI;IAAA,OAAE,CAACtC,OAAO2C,SAAS;GAAC;GAAA,IAAAJ,WAAA;IAAA,IAAAK,QAAAC,OAAA;IAAAT,OAAAQ,OAAAP,gBAEzB7C,QAAM;KACLsD,MAAI;KACJC,MAAI;KACJC,SAAO;KAAA,SAAA;KAAA,IAEPC,UAAO;MAAA,OAAEjD,OAAOkD;KAAI;KAAA,IAAAX,WAAA;MAAA,OAAA,CAAAF,gBAEnBnD,WAAS,CAAA,CAAA,GAAA,gBAAA;KAAA;IAAA,CAAA,CAAA;IAAA,OAAA0D;GAAA;EAAA,CAAA,GAAA,IAAA;EAAAO,aAAAC,UAAA/B,MA7BT9B,GAAG,yCAAyCmB,MAAM2C,KAAK,CAAC,CAAA;EAAA,OAAAhC;CAAA,EAAA,CAAA;AAoCrE"}

package/dist/components/conversation/index.d.ts

@@ -1,7 +1,7 @@
 export { ChatComposer, type ChatComposerProps, type ChatComposerControl } from './chat-composer';
 export { BusySendButton, type BusySendMode, type BusySendButtonProps } from './busy-send-button';
 export { ConversationAvatar, type ConversationAvatarKind, type ConversationAvatarProps, } from './conversation-avatar';
-export { ConversationSurface, type ConversationSurfaceProps } from './conversation-surface';
+export { ConversationSurface, type ConversationSurfaceProps, type ConversationReadingPosition, } from './conversation-surface';
 export { ComposerAttachmentButton, ComposerHint, MessageComposer, type MessageComposerProps, } from './message-composer';
 export { MessageBody, MessageDayDivider, MessageGroup, MessageRow, type MessageRowProps, } from './message-row';
 export { AttachmentCard, ThreadPanel, type AttachmentCardProps, type ThreadPanelProps, } from './thread-panel';

package/dist/components/conversation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/conversation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAChG,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAChG,OAAO,EACL,kBAAkB,EAClB,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,GAC7B,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,mBAAmB,EAAE,KAAK,wBAAwB,EAAE,MAAM,wBAAwB,CAAA;AAC3F,OAAO,EACL,wBAAwB,EACxB,YAAY,EACZ,eAAe,EACf,KAAK,oBAAoB,GAC1B,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,KAAK,eAAe,GACrB,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,cAAc,EACd,WAAW,EACX,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EACL,UAAU,EACV,SAAS,EACT,eAAe,EACf,WAAW,EACX,YAAY,EACZ,OAAO,EACP,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,uBAAuB,EACvB,YAAY,EACZ,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,KAAK,UAAU,GAChB,MAAM,gBAAgB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/conversation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAChG,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAChG,OAAO,EACL,kBAAkB,EAClB,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,GAC7B,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EACL,mBAAmB,EACnB,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,GACjC,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACL,wBAAwB,EACxB,YAAY,EACZ,eAAe,EACf,KAAK,oBAAoB,GAC1B,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,KAAK,eAAe,GACrB,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,cAAc,EACd,WAAW,EACX,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EACL,UAAU,EACV,SAAS,EACT,eAAe,EACf,WAAW,EACX,YAAY,EACZ,OAAO,EACP,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,uBAAuB,EACvB,YAAY,EACZ,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,KAAK,UAAU,GAChB,MAAM,gBAAgB,CAAA"}

package/dist/components/conversation/scroll-follow.d.ts

@@ -1,8 +1,11 @@
+import type { ConversationReadingPosition } from './conversation-surface';
 /** Internal plain-scroller binding; host-owned restoration can disable follow. */
 export declare function createScrollFollow(options: {
     enabled: () => boolean;
     resetKey: () => string | undefined;
     threshold: () => number;
+    initialPosition?: () => ConversationReadingPosition | undefined;
+    onPositionChange?: (position: ConversationReadingPosition) => void;
 }): {
     atBottom: import("solid-js").Accessor<boolean>;
     onScroll: () => void;

package/dist/components/conversation/scroll-follow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scroll-follow.d.ts","sourceRoot":"","sources":["../../../src/components/conversation/scroll-follow.ts"],"names":[],"mappings":"AA8BA,kFAAkF;AAClF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,OAAO,EAAE,MAAM,OAAO,CAAA;IACtB,QAAQ,EAAE,MAAM,MAAM,GAAG,SAAS,CAAA;IAClC,SAAS,EAAE,MAAM,MAAM,CAAA;CACxB;;;;4BA0F2B,cAAc;2BAGf,cAAc;EAIxC"}
+{"version":3,"file":"scroll-follow.d.ts","sourceRoot":"","sources":["../../../src/components/conversation/scroll-follow.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAA;AAezE,kFAAkF;AAClF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,OAAO,EAAE,MAAM,OAAO,CAAA;IACtB,QAAQ,EAAE,MAAM,MAAM,GAAG,SAAS,CAAA;IAClC,SAAS,EAAE,MAAM,MAAM,CAAA;IACvB,eAAe,CAAC,EAAE,MAAM,2BAA2B,GAAG,SAAS,CAAA;IAC/D,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,2BAA2B,KAAK,IAAI,CAAA;CACnE;;;;4BAsH2B,cAAc;2BAGf,cAAc;EAIxC"}

package/dist/components/conversation/scroll-follow.js

@@ -1,5 +1,5 @@
 import { bottomTarget, computeAtBottom, evaluateAutoPin, isSelfScroll, resolveUserScrollStick } from "./scroll-follow-core.js";
-import { createEffect, createSignal, onCleanup } from "solid-js";
+import { createEffect, createSignal, onCleanup, untrack } from "solid-js";
 //#region src/components/conversation/scroll-follow.ts
 var geometry = (element) => ({
 	scrollTop: element.scrollTop,
@@ -16,6 +16,13 @@ function createScrollFollow(options) {
 	let lastWriteClientHeight = -1;
 	let previousTop = -1;
 	let lastScrollClientHeight = 0;
+	const reportPosition = () => {
+		if (scroller) untrack(() => options.onPositionChange?.({
+			top: scroller.scrollTop,
+			following: options.enabled() && stick
+		}));
+	};
+	onCleanup(reportPosition);
 	const writePin = (element, target) => {
 		element.scrollTop = target;
 		lastWriteTop = target;
@@ -38,9 +45,14 @@ function createScrollFollow(options) {
 			lastWriteClientHeight = geom.clientHeight;
 		}
 		setAtBottom(computeAtBottom(geometry(scroller), options.threshold()));
+		reportPosition();
 	};
 	const onScroll = () => {
-		if (!scroller || !options.enabled()) return;
+		if (!scroller) return;
+		if (!options.enabled()) {
+			reportPosition();
+			return;
+		}
 		const geom = geometry(scroller);
 		setAtBottom(computeAtBottom(geom, options.threshold()));
 		if (!isSelfScroll(geom.scrollTop, lastWriteTop)) {
@@ -59,17 +71,20 @@ function createScrollFollow(options) {
 		}
 		previousTop = geom.scrollTop;
 		lastScrollClientHeight = geom.clientHeight;
+		reportPosition();
 	};
 	const jump = () => {
 		if (!scroller || !options.enabled()) return;
 		stick = true;
 		writePin(scroller, bottomTarget(geometry(scroller)));
 		setAtBottom(true);
+		reportPosition();
 		scroller.focus({ preventScroll: true });
 	};
 	createEffect(() => {
 		options.resetKey();
 		const enabled = options.enabled();
+		const initial = untrack(() => options.initialPosition?.());
 		stick = true;
 		lastWriteTop = -1;
 		lastWriteClientHeight = -1;
@@ -77,7 +92,14 @@ function createScrollFollow(options) {
 		lastScrollClientHeight = 0;
 		setAtBottom(true);
 		if (!enabled || !scroller) return;
-		writePin(scroller, bottomTarget(geometry(scroller)));
+		if (initial && Number.isFinite(initial.top) && initial.top >= 0) {
+			stick = initial.following;
+			writePin(scroller, stick ? bottomTarget(geometry(scroller)) : initial.top);
+			previousTop = scroller.scrollTop;
+			lastScrollClientHeight = scroller.clientHeight;
+		} else writePin(scroller, bottomTarget(geometry(scroller)));
+		setAtBottom(computeAtBottom(geometry(scroller), options.threshold()));
+		reportPosition();
 		if (typeof ResizeObserver === "undefined") return;
 		const observer = new ResizeObserver(pinAuto);
 		observer.observe(scroller);

package/dist/components/conversation/scroll-follow.js.map

@@ -1 +1 @@
-{"version":3,"file":"scroll-follow.js","names":[],"sources":["../../../src/components/conversation/scroll-follow.ts"],"sourcesContent":["/*\n * Substantially translated from KiroCrew website/src/app-sdk/useChatScrollFollow.ts,\n * pinned at 283e136c0f902e965a535a7c9548c57c7504fed0.\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * This product includes software developed at Amazon.com, Inc. (https://www.amazon.com/).\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy at http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software distributed\n * under the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR\n * CONDITIONS OF ANY KIND, either express or implied. See the License for the\n * specific language governing permissions and limitations under the License.\n * Solid owner effects replace React refs/effects; native geometry and the\n * content/viewport observer contract are retained. No session store is copied.\n */\nimport { createEffect, createSignal, onCleanup } from 'solid-js'\nimport {\n  bottomTarget,\n  computeAtBottom,\n  evaluateAutoPin,\n  isSelfScroll,\n  resolveUserScrollStick,\n} from './scroll-follow-core'\n\nconst geometry = (element: HTMLDivElement) => ({\n  scrollTop: element.scrollTop,\n  scrollHeight: element.scrollHeight,\n  clientHeight: element.clientHeight,\n})\n\n/** Internal plain-scroller binding; host-owned restoration can disable follow. */\nexport function createScrollFollow(options: {\n  enabled: () => boolean\n  resetKey: () => string | undefined\n  threshold: () => number\n}) {\n  const [atBottom, setAtBottom] = createSignal(true)\n  let scroller: HTMLDivElement | undefined\n  let content: HTMLDivElement | undefined\n  let stick = true\n  let lastWriteTop = -1\n  let lastWriteClientHeight = -1\n  let previousTop = -1\n  let lastScrollClientHeight = 0\n\n  const writePin = (element: HTMLDivElement, target: number) => {\n    // Instant writes keep the self-scroll reference synchronized. A smooth\n    // animation would produce intermediate positions that resemble user input.\n    element.scrollTop = target\n    lastWriteTop = target\n    lastWriteClientHeight = element.clientHeight\n    previousTop = target\n  }\n  const pinAuto = () => {\n    if (!scroller || !options.enabled()) return\n    const geom = geometry(scroller)\n    const result = evaluateAutoPin({\n      stick,\n      geom,\n      lastWriteTop,\n      viewportShrink: lastWriteClientHeight >= 0 ? lastWriteClientHeight - geom.clientHeight : 0,\n    })\n    stick = result.stick\n    if (result.pin) writePin(scroller, result.target)\n    else if (result.stick) {\n      lastWriteTop = result.target\n      lastWriteClientHeight = geom.clientHeight\n    }\n    setAtBottom(computeAtBottom(geometry(scroller), options.threshold()))\n  }\n  const onScroll = () => {\n    if (!scroller || !options.enabled()) return\n    const geom = geometry(scroller)\n    setAtBottom(computeAtBottom(geom, options.threshold()))\n    if (!isSelfScroll(geom.scrollTop, lastWriteTop)) {\n      stick = resolveUserScrollStick({\n        stick,\n        followOutput: true,\n        scrollTop: geom.scrollTop,\n        prevScrollTop: previousTop,\n        geom,\n        viewportGrowth: lastScrollClientHeight > 0 ? geom.clientHeight - lastScrollClientHeight : 0,\n      })\n      if (!stick) {\n        lastWriteTop = -1\n        lastWriteClientHeight = -1\n      }\n    }\n    previousTop = geom.scrollTop\n    // This baseline belongs only to scroll events, not observer callbacks.\n    // Advancing it during resize would erase the viewport-clamp evidence.\n    lastScrollClientHeight = geom.clientHeight\n  }\n  const jump = () => {\n    if (!scroller || !options.enabled()) return\n    stick = true\n    writePin(scroller, bottomTarget(geometry(scroller)))\n    setAtBottom(true)\n    // The jump control disappears at the bottom. Return its keyboard focus to\n    // the transcript instead of leaving the reader on a detached button.\n    scroller.focus({ preventScroll: true })\n  }\n\n  createEffect(() => {\n    options.resetKey()\n    const enabled = options.enabled()\n    stick = true\n    lastWriteTop = -1\n    lastWriteClientHeight = -1\n    previousTop = -1\n    lastScrollClientHeight = 0\n    setAtBottom(true)\n    if (!enabled || !scroller) return\n    writePin(scroller, bottomTarget(geometry(scroller)))\n    if (typeof ResizeObserver === 'undefined') return\n    const observer = new ResizeObserver(pinAuto)\n    observer.observe(scroller)\n    if (content) observer.observe(content)\n    onCleanup(() => observer.disconnect())\n  })\n\n  return {\n    atBottom,\n    onScroll,\n    jump,\n    bindScroller: (element: HTMLDivElement) => {\n      scroller = element\n    },\n    bindContent: (element: HTMLDivElement) => {\n      content = element\n    },\n  }\n}\n"],"mappings":";;;AAwBA,IAAM,YAAY,aAA6B;CAC7C,WAAW,QAAQ;CACnB,cAAc,QAAQ;CACtB,cAAc,QAAQ;AACxB;;AAGA,SAAgB,mBAAmB,SAIhC;CACD,MAAM,CAAC,UAAU,eAAe,aAAa,IAAI;CACjD,IAAI;CACJ,IAAI;CACJ,IAAI,QAAQ;CACZ,IAAI,eAAe;CACnB,IAAI,wBAAwB;CAC5B,IAAI,cAAc;CAClB,IAAI,yBAAyB;CAE7B,MAAM,YAAY,SAAyB,WAAmB;EAG5D,QAAQ,YAAY;EACpB,eAAe;EACf,wBAAwB,QAAQ;EAChC,cAAc;CAChB;CACA,MAAM,gBAAgB;EACpB,IAAI,CAAC,YAAY,CAAC,QAAQ,QAAQ,GAAG;EACrC,MAAM,OAAO,SAAS,QAAQ;EAC9B,MAAM,SAAS,gBAAgB;GAC7B;GACA;GACA;GACA,gBAAgB,yBAAyB,IAAI,wBAAwB,KAAK,eAAe;EAC3F,CAAC;EACD,QAAQ,OAAO;EACf,IAAI,OAAO,KAAK,SAAS,UAAU,OAAO,MAAM;OAC3C,IAAI,OAAO,OAAO;GACrB,eAAe,OAAO;GACtB,wBAAwB,KAAK;EAC/B;EACA,YAAY,gBAAgB,SAAS,QAAQ,GAAG,QAAQ,UAAU,CAAC,CAAC;CACtE;CACA,MAAM,iBAAiB;EACrB,IAAI,CAAC,YAAY,CAAC,QAAQ,QAAQ,GAAG;EACrC,MAAM,OAAO,SAAS,QAAQ;EAC9B,YAAY,gBAAgB,MAAM,QAAQ,UAAU,CAAC,CAAC;EACtD,IAAI,CAAC,aAAa,KAAK,WAAW,YAAY,GAAG;GAC/C,QAAQ,uBAAuB;IAC7B;IACA,cAAc;IACd,WAAW,KAAK;IAChB,eAAe;IACf;IACA,gBAAgB,yBAAyB,IAAI,KAAK,eAAe,yBAAyB;GAC5F,CAAC;GACD,IAAI,CAAC,OAAO;IACV,eAAe;IACf,wBAAwB;GAC1B;EACF;EACA,cAAc,KAAK;EAGnB,yBAAyB,KAAK;CAChC;CACA,MAAM,aAAa;EACjB,IAAI,CAAC,YAAY,CAAC,QAAQ,QAAQ,GAAG;EACrC,QAAQ;EACR,SAAS,UAAU,aAAa,SAAS,QAAQ,CAAC,CAAC;EACnD,YAAY,IAAI;EAGhB,SAAS,MAAM,EAAE,eAAe,KAAK,CAAC;CACxC;CAEA,mBAAmB;EACjB,QAAQ,SAAS;EACjB,MAAM,UAAU,QAAQ,QAAQ;EAChC,QAAQ;EACR,eAAe;EACf,wBAAwB;EACxB,cAAc;EACd,yBAAyB;EACzB,YAAY,IAAI;EAChB,IAAI,CAAC,WAAW,CAAC,UAAU;EAC3B,SAAS,UAAU,aAAa,SAAS,QAAQ,CAAC,CAAC;EACnD,IAAI,OAAO,mBAAmB,aAAa;EAC3C,MAAM,WAAW,IAAI,eAAe,OAAO;EAC3C,SAAS,QAAQ,QAAQ;EACzB,IAAI,SAAS,SAAS,QAAQ,OAAO;EACrC,gBAAgB,SAAS,WAAW,CAAC;CACvC,CAAC;CAED,OAAO;EACL;EACA;EACA;EACA,eAAe,YAA4B;GACzC,WAAW;EACb;EACA,cAAc,YAA4B;GACxC,UAAU;EACZ;CACF;AACF"}
+{"version":3,"file":"scroll-follow.js","names":[],"sources":["../../../src/components/conversation/scroll-follow.ts"],"sourcesContent":["/*\n * Substantially translated from KiroCrew website/src/app-sdk/useChatScrollFollow.ts,\n * pinned at 283e136c0f902e965a535a7c9548c57c7504fed0.\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * This product includes software developed at Amazon.com, Inc. (https://www.amazon.com/).\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy at http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software distributed\n * under the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR\n * CONDITIONS OF ANY KIND, either express or implied. See the License for the\n * specific language governing permissions and limitations under the License.\n * Solid owner effects replace React refs/effects; native geometry and the\n * content/viewport observer contract are retained. No session store is copied.\n */\nimport { createEffect, createSignal, onCleanup, untrack } from 'solid-js'\nimport type { ConversationReadingPosition } from './conversation-surface'\nimport {\n  bottomTarget,\n  computeAtBottom,\n  evaluateAutoPin,\n  isSelfScroll,\n  resolveUserScrollStick,\n} from './scroll-follow-core'\n\nconst geometry = (element: HTMLDivElement) => ({\n  scrollTop: element.scrollTop,\n  scrollHeight: element.scrollHeight,\n  clientHeight: element.clientHeight,\n})\n\n/** Internal plain-scroller binding; host-owned restoration can disable follow. */\nexport function createScrollFollow(options: {\n  enabled: () => boolean\n  resetKey: () => string | undefined\n  threshold: () => number\n  initialPosition?: () => ConversationReadingPosition | undefined\n  onPositionChange?: (position: ConversationReadingPosition) => void\n}) {\n  const [atBottom, setAtBottom] = createSignal(true)\n  let scroller: HTMLDivElement | undefined\n  let content: HTMLDivElement | undefined\n  let stick = true\n  let lastWriteTop = -1\n  let lastWriteClientHeight = -1\n  let previousTop = -1\n  let lastScrollClientHeight = 0\n  const reportPosition = () => {\n    if (scroller)\n      untrack(() =>\n        options.onPositionChange?.({\n          top: scroller!.scrollTop,\n          following: options.enabled() && stick,\n        })\n      )\n  }\n  onCleanup(reportPosition)\n\n  const writePin = (element: HTMLDivElement, target: number) => {\n    // Instant writes keep the self-scroll reference synchronized. A smooth\n    // animation would produce intermediate positions that resemble user input.\n    element.scrollTop = target\n    lastWriteTop = target\n    lastWriteClientHeight = element.clientHeight\n    previousTop = target\n  }\n  const pinAuto = () => {\n    if (!scroller || !options.enabled()) return\n    const geom = geometry(scroller)\n    const result = evaluateAutoPin({\n      stick,\n      geom,\n      lastWriteTop,\n      viewportShrink: lastWriteClientHeight >= 0 ? lastWriteClientHeight - geom.clientHeight : 0,\n    })\n    stick = result.stick\n    if (result.pin) writePin(scroller, result.target)\n    else if (result.stick) {\n      lastWriteTop = result.target\n      lastWriteClientHeight = geom.clientHeight\n    }\n    setAtBottom(computeAtBottom(geometry(scroller), options.threshold()))\n    reportPosition()\n  }\n  const onScroll = () => {\n    if (!scroller) return\n    if (!options.enabled()) {\n      reportPosition()\n      return\n    }\n    const geom = geometry(scroller)\n    setAtBottom(computeAtBottom(geom, options.threshold()))\n    if (!isSelfScroll(geom.scrollTop, lastWriteTop)) {\n      stick = resolveUserScrollStick({\n        stick,\n        followOutput: true,\n        scrollTop: geom.scrollTop,\n        prevScrollTop: previousTop,\n        geom,\n        viewportGrowth: lastScrollClientHeight > 0 ? geom.clientHeight - lastScrollClientHeight : 0,\n      })\n      if (!stick) {\n        lastWriteTop = -1\n        lastWriteClientHeight = -1\n      }\n    }\n    previousTop = geom.scrollTop\n    // This baseline belongs only to scroll events, not observer callbacks.\n    // Advancing it during resize would erase the viewport-clamp evidence.\n    lastScrollClientHeight = geom.clientHeight\n    reportPosition()\n  }\n  const jump = () => {\n    if (!scroller || !options.enabled()) return\n    stick = true\n    writePin(scroller, bottomTarget(geometry(scroller)))\n    setAtBottom(true)\n    reportPosition()\n    // The jump control disappears at the bottom. Return its keyboard focus to\n    // the transcript instead of leaving the reader on a detached button.\n    scroller.focus({ preventScroll: true })\n  }\n\n  createEffect(() => {\n    options.resetKey()\n    const enabled = options.enabled()\n    // Capture before any reporting callback can replace the host snapshot.\n    const initial = untrack(() => options.initialPosition?.())\n    stick = true\n    lastWriteTop = -1\n    lastWriteClientHeight = -1\n    previousTop = -1\n    lastScrollClientHeight = 0\n    setAtBottom(true)\n    if (!enabled || !scroller) return\n    // Snapshot updates must not become another positioning owner. Consume the\n    // host's snapshot only at entry/reset, then native reader intent owns follow.\n    if (initial && Number.isFinite(initial.top) && initial.top >= 0) {\n      stick = initial.following\n      writePin(scroller, stick ? bottomTarget(geometry(scroller)) : initial.top)\n      previousTop = scroller.scrollTop\n      lastScrollClientHeight = scroller.clientHeight\n    } else writePin(scroller, bottomTarget(geometry(scroller)))\n    setAtBottom(computeAtBottom(geometry(scroller), options.threshold()))\n    reportPosition()\n    if (typeof ResizeObserver === 'undefined') return\n    const observer = new ResizeObserver(pinAuto)\n    observer.observe(scroller)\n    if (content) observer.observe(content)\n    onCleanup(() => observer.disconnect())\n  })\n\n  return {\n    atBottom,\n    onScroll,\n    jump,\n    bindScroller: (element: HTMLDivElement) => {\n      scroller = element\n    },\n    bindContent: (element: HTMLDivElement) => {\n      content = element\n    },\n  }\n}\n"],"mappings":";;;AAyBA,IAAM,YAAY,aAA6B;CAC7C,WAAW,QAAQ;CACnB,cAAc,QAAQ;CACtB,cAAc,QAAQ;AACxB;;AAGA,SAAgB,mBAAmB,SAMhC;CACD,MAAM,CAAC,UAAU,eAAe,aAAa,IAAI;CACjD,IAAI;CACJ,IAAI;CACJ,IAAI,QAAQ;CACZ,IAAI,eAAe;CACnB,IAAI,wBAAwB;CAC5B,IAAI,cAAc;CAClB,IAAI,yBAAyB;CAC7B,MAAM,uBAAuB;EAC3B,IAAI,UACF,cACE,QAAQ,mBAAmB;GACzB,KAAK,SAAU;GACf,WAAW,QAAQ,QAAQ,KAAK;EAClC,CAAC,CACH;CACJ;CACA,UAAU,cAAc;CAExB,MAAM,YAAY,SAAyB,WAAmB;EAG5D,QAAQ,YAAY;EACpB,eAAe;EACf,wBAAwB,QAAQ;EAChC,cAAc;CAChB;CACA,MAAM,gBAAgB;EACpB,IAAI,CAAC,YAAY,CAAC,QAAQ,QAAQ,GAAG;EACrC,MAAM,OAAO,SAAS,QAAQ;EAC9B,MAAM,SAAS,gBAAgB;GAC7B;GACA;GACA;GACA,gBAAgB,yBAAyB,IAAI,wBAAwB,KAAK,eAAe;EAC3F,CAAC;EACD,QAAQ,OAAO;EACf,IAAI,OAAO,KAAK,SAAS,UAAU,OAAO,MAAM;OAC3C,IAAI,OAAO,OAAO;GACrB,eAAe,OAAO;GACtB,wBAAwB,KAAK;EAC/B;EACA,YAAY,gBAAgB,SAAS,QAAQ,GAAG,QAAQ,UAAU,CAAC,CAAC;EACpE,eAAe;CACjB;CACA,MAAM,iBAAiB;EACrB,IAAI,CAAC,UAAU;EACf,IAAI,CAAC,QAAQ,QAAQ,GAAG;GACtB,eAAe;GACf;EACF;EACA,MAAM,OAAO,SAAS,QAAQ;EAC9B,YAAY,gBAAgB,MAAM,QAAQ,UAAU,CAAC,CAAC;EACtD,IAAI,CAAC,aAAa,KAAK,WAAW,YAAY,GAAG;GAC/C,QAAQ,uBAAuB;IAC7B;IACA,cAAc;IACd,WAAW,KAAK;IAChB,eAAe;IACf;IACA,gBAAgB,yBAAyB,IAAI,KAAK,eAAe,yBAAyB;GAC5F,CAAC;GACD,IAAI,CAAC,OAAO;IACV,eAAe;IACf,wBAAwB;GAC1B;EACF;EACA,cAAc,KAAK;EAGnB,yBAAyB,KAAK;EAC9B,eAAe;CACjB;CACA,MAAM,aAAa;EACjB,IAAI,CAAC,YAAY,CAAC,QAAQ,QAAQ,GAAG;EACrC,QAAQ;EACR,SAAS,UAAU,aAAa,SAAS,QAAQ,CAAC,CAAC;EACnD,YAAY,IAAI;EAChB,eAAe;EAGf,SAAS,MAAM,EAAE,eAAe,KAAK,CAAC;CACxC;CAEA,mBAAmB;EACjB,QAAQ,SAAS;EACjB,MAAM,UAAU,QAAQ,QAAQ;EAEhC,MAAM,UAAU,cAAc,QAAQ,kBAAkB,CAAC;EACzD,QAAQ;EACR,eAAe;EACf,wBAAwB;EACxB,cAAc;EACd,yBAAyB;EACzB,YAAY,IAAI;EAChB,IAAI,CAAC,WAAW,CAAC,UAAU;EAG3B,IAAI,WAAW,OAAO,SAAS,QAAQ,GAAG,KAAK,QAAQ,OAAO,GAAG;GAC/D,QAAQ,QAAQ;GAChB,SAAS,UAAU,QAAQ,aAAa,SAAS,QAAQ,CAAC,IAAI,QAAQ,GAAG;GACzE,cAAc,SAAS;GACvB,yBAAyB,SAAS;EACpC,OAAO,SAAS,UAAU,aAAa,SAAS,QAAQ,CAAC,CAAC;EAC1D,YAAY,gBAAgB,SAAS,QAAQ,GAAG,QAAQ,UAAU,CAAC,CAAC;EACpE,eAAe;EACf,IAAI,OAAO,mBAAmB,aAAa;EAC3C,MAAM,WAAW,IAAI,eAAe,OAAO;EAC3C,SAAS,QAAQ,QAAQ;EACzB,IAAI,SAAS,SAAS,QAAQ,OAAO;EACrC,gBAAgB,SAAS,WAAW,CAAC;CACvC,CAAC;CAED,OAAO;EACL;EACA;EACA;EACA,eAAe,YAA4B;GACzC,WAAW;EACb;EACA,cAAc,YAA4B;GACxC,UAAU;EACZ;CACF;AACF"}

package/dist/r/src/components/conversation/conversation-surface.tsx

@@ -21,6 +21,8 @@ import { createScrollFollow } from './scroll-follow'
  *     than dragging the pane behind it — which in a desktop shell means the whole
  *     window moves.
  */
+export type ConversationReadingPosition = Readonly<{ top: number; following: boolean }>
+
 export type ConversationSurfaceProps = ComponentProps<'div'> & {
   /** How far from the bottom still counts as "at the bottom", in px. */
   threshold?: number
@@ -28,6 +30,10 @@ export type ConversationSurfaceProps = ComponentProps<'div'> & {
   follow?: boolean
   /** Optional conversation identity: changing it re-arms follow at the bottom. */
   resetKey?: string
+  /** Host snapshot consumed on mount/identity reset, never on ordinary prop updates. */
+  initialReadingPosition?: ConversationReadingPosition
+  /** Actual follow intent and native offset; storage/identity remain host-owned. */
+  onReadingPositionChange?: (position: ConversationReadingPosition) => void
   /** Rendered above the transcript when there is nothing in it. */
   empty?: JSX.Element
   /** A header that scrolls with the transcript, e.g. a day divider or a banner. */
@@ -40,6 +46,8 @@ export function ConversationSurface(props: ConversationSurfaceProps) {
     'threshold',
     'follow',
     'resetKey',
+    'initialReadingPosition',
+    'onReadingPositionChange',
     'empty',
     'header',
     'children',
@@ -54,6 +62,8 @@ export function ConversationSurface(props: ConversationSurfaceProps) {
     enabled: () => local.follow !== false,
     resetKey: () => local.resetKey,
     threshold: () => local.threshold ?? 80,
+    initialPosition: () => local.initialReadingPosition,
+    onPositionChange: (position) => local.onReadingPositionChange?.(position),
   })
   const onScroll: JSX.EventHandlerUnion<HTMLDivElement, Event> = (event) => {
     follow.onScroll()

package/dist/r/src/components/conversation/index.ts

@@ -5,7 +5,11 @@ export {
   type ConversationAvatarKind,
   type ConversationAvatarProps,
 } from './conversation-avatar'
-export { ConversationSurface, type ConversationSurfaceProps } from './conversation-surface'
+export {
+  ConversationSurface,
+  type ConversationSurfaceProps,
+  type ConversationReadingPosition,
+} from './conversation-surface'
 export {
   ComposerAttachmentButton,
   ComposerHint,

package/dist/r/src/components/conversation/scroll-follow.ts

@@ -13,7 +13,8 @@
  * Solid owner effects replace React refs/effects; native geometry and the
  * content/viewport observer contract are retained. No session store is copied.
  */
-import { createEffect, createSignal, onCleanup } from 'solid-js'
+import { createEffect, createSignal, onCleanup, untrack } from 'solid-js'
+import type { ConversationReadingPosition } from './conversation-surface'
 import {
   bottomTarget,
   computeAtBottom,
@@ -33,6 +34,8 @@ export function createScrollFollow(options: {
   enabled: () => boolean
   resetKey: () => string | undefined
   threshold: () => number
+  initialPosition?: () => ConversationReadingPosition | undefined
+  onPositionChange?: (position: ConversationReadingPosition) => void
 }) {
   const [atBottom, setAtBottom] = createSignal(true)
   let scroller: HTMLDivElement | undefined
@@ -42,6 +45,16 @@ export function createScrollFollow(options: {
   let lastWriteClientHeight = -1
   let previousTop = -1
   let lastScrollClientHeight = 0
+  const reportPosition = () => {
+    if (scroller)
+      untrack(() =>
+        options.onPositionChange?.({
+          top: scroller!.scrollTop,
+          following: options.enabled() && stick,
+        })
+      )
+  }
+  onCleanup(reportPosition)
 
   const writePin = (element: HTMLDivElement, target: number) => {
     // Instant writes keep the self-scroll reference synchronized. A smooth
@@ -67,9 +80,14 @@ export function createScrollFollow(options: {
       lastWriteClientHeight = geom.clientHeight
     }
     setAtBottom(computeAtBottom(geometry(scroller), options.threshold()))
+    reportPosition()
   }
   const onScroll = () => {
-    if (!scroller || !options.enabled()) return
+    if (!scroller) return
+    if (!options.enabled()) {
+      reportPosition()
+      return
+    }
     const geom = geometry(scroller)
     setAtBottom(computeAtBottom(geom, options.threshold()))
     if (!isSelfScroll(geom.scrollTop, lastWriteTop)) {
@@ -90,12 +108,14 @@ export function createScrollFollow(options: {
     // This baseline belongs only to scroll events, not observer callbacks.
     // Advancing it during resize would erase the viewport-clamp evidence.
     lastScrollClientHeight = geom.clientHeight
+    reportPosition()
   }
   const jump = () => {
     if (!scroller || !options.enabled()) return
     stick = true
     writePin(scroller, bottomTarget(geometry(scroller)))
     setAtBottom(true)
+    reportPosition()
     // The jump control disappears at the bottom. Return its keyboard focus to
     // the transcript instead of leaving the reader on a detached button.
     scroller.focus({ preventScroll: true })
@@ -104,6 +124,8 @@ export function createScrollFollow(options: {
   createEffect(() => {
     options.resetKey()
     const enabled = options.enabled()
+    // Capture before any reporting callback can replace the host snapshot.
+    const initial = untrack(() => options.initialPosition?.())
     stick = true
     lastWriteTop = -1
     lastWriteClientHeight = -1
@@ -111,7 +133,16 @@ export function createScrollFollow(options: {
     lastScrollClientHeight = 0
     setAtBottom(true)
     if (!enabled || !scroller) return
-    writePin(scroller, bottomTarget(geometry(scroller)))
+    // Snapshot updates must not become another positioning owner. Consume the
+    // host's snapshot only at entry/reset, then native reader intent owns follow.
+    if (initial && Number.isFinite(initial.top) && initial.top >= 0) {
+      stick = initial.following
+      writePin(scroller, stick ? bottomTarget(geometry(scroller)) : initial.top)
+      previousTop = scroller.scrollTop
+      lastScrollClientHeight = scroller.clientHeight
+    } else writePin(scroller, bottomTarget(geometry(scroller)))
+    setAtBottom(computeAtBottom(geometry(scroller), options.threshold()))
+    reportPosition()
     if (typeof ResizeObserver === 'undefined') return
     const observer = new ResizeObserver(pinAuto)
     observer.observe(scroller)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adea-ai/ui",
-  "version": "0.67.0",
+  "version": "0.67.2",
   "description": "The Adea design system: Kobalte-backed Solid components, semantic OKLCH tokens, and the app-shell layout primitives shared by Adea and Cortana.",
   "keywords": [
     "adea",

package/src/components/conversation/conversation-surface.tsx

@@ -21,6 +21,8 @@ import { createScrollFollow } from './scroll-follow'
  *     than dragging the pane behind it — which in a desktop shell means the whole
  *     window moves.
  */
+export type ConversationReadingPosition = Readonly<{ top: number; following: boolean }>
+
 export type ConversationSurfaceProps = ComponentProps<'div'> & {
   /** How far from the bottom still counts as "at the bottom", in px. */
   threshold?: number
@@ -28,6 +30,10 @@ export type ConversationSurfaceProps = ComponentProps<'div'> & {
   follow?: boolean
   /** Optional conversation identity: changing it re-arms follow at the bottom. */
   resetKey?: string
+  /** Host snapshot consumed on mount/identity reset, never on ordinary prop updates. */
+  initialReadingPosition?: ConversationReadingPosition
+  /** Actual follow intent and native offset; storage/identity remain host-owned. */
+  onReadingPositionChange?: (position: ConversationReadingPosition) => void
   /** Rendered above the transcript when there is nothing in it. */
   empty?: JSX.Element
   /** A header that scrolls with the transcript, e.g. a day divider or a banner. */
@@ -40,6 +46,8 @@ export function ConversationSurface(props: ConversationSurfaceProps) {
     'threshold',
     'follow',
     'resetKey',
+    'initialReadingPosition',
+    'onReadingPositionChange',
     'empty',
     'header',
     'children',
@@ -54,6 +62,8 @@ export function ConversationSurface(props: ConversationSurfaceProps) {
     enabled: () => local.follow !== false,
     resetKey: () => local.resetKey,
     threshold: () => local.threshold ?? 80,
+    initialPosition: () => local.initialReadingPosition,
+    onPositionChange: (position) => local.onReadingPositionChange?.(position),
   })
   const onScroll: JSX.EventHandlerUnion<HTMLDivElement, Event> = (event) => {
     follow.onScroll()

package/src/components/conversation/index.ts

@@ -5,7 +5,11 @@ export {
   type ConversationAvatarKind,
   type ConversationAvatarProps,
 } from './conversation-avatar'
-export { ConversationSurface, type ConversationSurfaceProps } from './conversation-surface'
+export {
+  ConversationSurface,
+  type ConversationSurfaceProps,
+  type ConversationReadingPosition,
+} from './conversation-surface'
 export {
   ComposerAttachmentButton,
   ComposerHint,

package/src/components/conversation/scroll-follow.ts

@@ -13,7 +13,8 @@
  * Solid owner effects replace React refs/effects; native geometry and the
  * content/viewport observer contract are retained. No session store is copied.
  */
-import { createEffect, createSignal, onCleanup } from 'solid-js'
+import { createEffect, createSignal, onCleanup, untrack } from 'solid-js'
+import type { ConversationReadingPosition } from './conversation-surface'
 import {
   bottomTarget,
   computeAtBottom,
@@ -33,6 +34,8 @@ export function createScrollFollow(options: {
   enabled: () => boolean
   resetKey: () => string | undefined
   threshold: () => number
+  initialPosition?: () => ConversationReadingPosition | undefined
+  onPositionChange?: (position: ConversationReadingPosition) => void
 }) {
   const [atBottom, setAtBottom] = createSignal(true)
   let scroller: HTMLDivElement | undefined
@@ -42,6 +45,16 @@ export function createScrollFollow(options: {
   let lastWriteClientHeight = -1
   let previousTop = -1
   let lastScrollClientHeight = 0
+  const reportPosition = () => {
+    if (scroller)
+      untrack(() =>
+        options.onPositionChange?.({
+          top: scroller!.scrollTop,
+          following: options.enabled() && stick,
+        })
+      )
+  }
+  onCleanup(reportPosition)
 
   const writePin = (element: HTMLDivElement, target: number) => {
     // Instant writes keep the self-scroll reference synchronized. A smooth
@@ -67,9 +80,14 @@ export function createScrollFollow(options: {
       lastWriteClientHeight = geom.clientHeight
     }
     setAtBottom(computeAtBottom(geometry(scroller), options.threshold()))
+    reportPosition()
   }
   const onScroll = () => {
-    if (!scroller || !options.enabled()) return
+    if (!scroller) return
+    if (!options.enabled()) {
+      reportPosition()
+      return
+    }
     const geom = geometry(scroller)
     setAtBottom(computeAtBottom(geom, options.threshold()))
     if (!isSelfScroll(geom.scrollTop, lastWriteTop)) {
@@ -90,12 +108,14 @@ export function createScrollFollow(options: {
     // This baseline belongs only to scroll events, not observer callbacks.
     // Advancing it during resize would erase the viewport-clamp evidence.
     lastScrollClientHeight = geom.clientHeight
+    reportPosition()
   }
   const jump = () => {
     if (!scroller || !options.enabled()) return
     stick = true
     writePin(scroller, bottomTarget(geometry(scroller)))
     setAtBottom(true)
+    reportPosition()
     // The jump control disappears at the bottom. Return its keyboard focus to
     // the transcript instead of leaving the reader on a detached button.
     scroller.focus({ preventScroll: true })
@@ -104,6 +124,8 @@ export function createScrollFollow(options: {
   createEffect(() => {
     options.resetKey()
     const enabled = options.enabled()
+    // Capture before any reporting callback can replace the host snapshot.
+    const initial = untrack(() => options.initialPosition?.())
     stick = true
     lastWriteTop = -1
     lastWriteClientHeight = -1
@@ -111,7 +133,16 @@ export function createScrollFollow(options: {
     lastScrollClientHeight = 0
     setAtBottom(true)
     if (!enabled || !scroller) return
-    writePin(scroller, bottomTarget(geometry(scroller)))
+    // Snapshot updates must not become another positioning owner. Consume the
+    // host's snapshot only at entry/reset, then native reader intent owns follow.
+    if (initial && Number.isFinite(initial.top) && initial.top >= 0) {
+      stick = initial.following
+      writePin(scroller, stick ? bottomTarget(geometry(scroller)) : initial.top)
+      previousTop = scroller.scrollTop
+      lastScrollClientHeight = scroller.clientHeight
+    } else writePin(scroller, bottomTarget(geometry(scroller)))
+    setAtBottom(computeAtBottom(geometry(scroller), options.threshold()))
+    reportPosition()
     if (typeof ResizeObserver === 'undefined') return
     const observer = new ResizeObserver(pinAuto)
     observer.observe(scroller)