@djangocfg/ui-tools 2.1.404 → 2.1.408

package/src/tools/Chat/components/ChatRoot.tsx

@@ -1,305 +0,0 @@
-'use client';
-
-import { type ReactNode, useMemo, useRef, useState } from 'react';
-
-import { cn } from '@djangocfg/ui-core/lib';
-
-import type { ChatAttachment, ChatConfig, ChatMessage, ChatTransport } from '../types';
-import type { ChatAudioConfig } from '../core/audio/types';
-import {
-  ChatProvider,
-  useChatContext,
-  useChatContextOptional,
-  type ChatContextValue,
-} from '../context';
-import { useAutoFocusOnStreamEnd } from '../hooks/useAutoFocusOnStreamEnd';
-import { useChatComposer, type UseChatComposerReturn } from '../hooks/useChatComposer';
-import { useFocusOnEmptyClick } from '../hooks/useFocusOnEmptyClick';
-import { Composer, type ComposerSize } from './Composer';
-import { EmptyState } from './EmptyState';
-import { ErrorBanner } from './ErrorBanner';
-import { JumpToLatest } from './JumpToLatest';
-import { MessageBubble } from './MessageBubble';
-import { MessageList, type MessageListHandle } from './MessageList';
-import type { AttachmentRendererMap } from './Attachments';
-import type { ToolCallsProps } from './ToolCalls';
-
-export interface ChatRootProps {
-  // ---- core wiring -------------------------------------------------------
-  /**
-   * Transport. Required UNLESS `<ChatRoot>` is rendered inside an
-   * existing `<ChatProvider>` (e.g. mounted by `<ChatLauncher>`), in
-   * which case the ambient provider is reused and `transport` is
-   * ignored.
-   */
-  transport?: ChatTransport;
-  config?: ChatConfig;
-  initialSessionId?: string;
-  autoCreateSession?: boolean;
-  streaming?: boolean;
-  /** Audio-trigger configuration. Off by default (no `sounds` map). */
-  audio?: ChatAudioConfig;
-  /**
-   * Verbose dev-mode logging via `consola` (namespace `chat:*`).
-   * Defaults to `isDev` from `@djangocfg/ui-core/lib`. Pass `false` to silence
-   * even in development, or `true` to force on in production for debugging.
-   */
-  debug?: boolean;
-  className?: string;
-
-  // ---- named ReactNode slots --------------------------------------------
-  /** Sticky banner above the message list (e.g. quota warning). */
-  banner?: ReactNode;
-  /** Header row below the banner — title / actions / session switcher. */
-  header?: ReactNode;
-  /** Footer slot below the composer (disclaimers, model picker). */
-  footer?: ReactNode;
-  /** Replaces the default `<EmptyState>` rendered when the conversation is empty. */
-  empty?: ReactNode;
-  /** Slot left of the textarea inside `<Composer>`. */
-  composerToolbarStart?: ReactNode;
-  /** Slot right of the textarea inside `<Composer>`. */
-  composerToolbarEnd?: ReactNode;
-  /** Replaces the default attachment tray inside `<Composer>`. */
-  composerAttachmentTray?: ReactNode;
-  /** Replaces the default `<JumpToLatest>` floating pill. */
-  jumpToLatest?: ReactNode;
-
-  // ---- render-prop slots (need access to data) --------------------------
-  /** Replace `<MessageBubble>` per message. */
-  renderMessage?: (m: ChatMessage, i: number) => ReactNode;
-  /**
-   * Render arbitrary content beneath every default `<MessageBubble>`
-   * (not invoked when `renderMessage` is set — the host owns layout
-   * in that case). Useful for product widgets driven by a side channel
-   * (e.g. `ui_payload` SSE frames) where the widget is per-message but
-   * not tied to the bubble's tool-calls array.
-   */
-  renderAfterMessage?: (m: ChatMessage) => ReactNode;
-  /** Render the header lazily — receives the chat context. */
-  renderHeader?: (ctx: ChatContextValue) => ReactNode;
-  /** Render the empty-state lazily — receives a `setValue` to seed the composer. */
-  renderEmpty?: (api: { setValue: (v: string) => void; focus: () => void }) => ReactNode;
-  /**
-   * Replace the default `<Composer>` entirely. Receives the live
-   * `useChatComposer` return and the composer-related slot props
-   * (placeholder, size, attach button, toolbar slots) — host can wire
-   * them into a custom widget (e.g. a MarkdownEditor with mentions).
-   *
-   * When set, `composerToolbarStart/End`, `composerAttachmentTray`,
-   * `composerSize`, `showAttachmentButton`, `onPickFiles` are passed
-   * to the render-prop but are no longer auto-rendered.
-   */
-  renderComposer?: (api: {
-    composer: UseChatComposerReturn;
-    placeholder?: string;
-    size?: ComposerSize;
-    showAttachmentButton?: boolean;
-    onPickFiles?: () => void;
-    toolbarStart?: ReactNode;
-    toolbarEnd?: ReactNode;
-    attachmentTray?: ReactNode;
-  }) => ReactNode;
-  /** Forwarded into `<MessageBubble toolCallsProps>` so hosts can swap payload renderers. */
-  toolCallsProps?: Omit<ToolCallsProps, 'calls'>;
-  /** Per-type attachment renderers — `{ image, audio, video, file, default }`. */
-  attachmentRenderers?: AttachmentRendererMap;
-  /** Called when an attachment tile is clicked (e.g. open lightbox). */
-  onAttachmentOpen?: (attachment: ChatAttachment) => void;
-
-  // ---- composer customization -------------------------------------------
-  /** Show the paperclip "attach" button in the composer. */
-  showAttachmentButton?: boolean;
-  /** Called when the user clicks the attach button (host opens its file picker). */
-  onPickFiles?: () => void;
-  /** Hide the composer input area entirely (e.g. while waiting for human approval). */
-  hideComposer?: boolean;
-  /** Composer size variant. Default ``md`` (36px slot). Use ``lg`` for primary
-   * surfaces (onboarding, full-page chat), ``sm`` for dense sidebars. */
-  composerSize?: ComposerSize;
-  /** Extra className forwarded to the `<MessageList>` scroll container.
-   * Use to add padding inside the scroll area so the scrollbar stays flush
-   * with the edge (e.g. `"px-6 pt-6 sm:px-8"`). */
-  listClassName?: string;
-  /** Extra className forwarded to the `<Composer>` wrapper div. */
-  composerClassName?: string;
-  /**
-   * Click in the message area → focus the composer (Slack / ChatGPT / Linear).
-   * Honours selection drag, interactive elements, and touch input.
-   * @default true
-   */
-  focusOnEmptyClick?: boolean;
-}
-
-export function ChatRoot(props: ChatRootProps) {
-  const { transport, config, initialSessionId, autoCreateSession, streaming, audio, debug, className, listClassName, ...slots } = props;
-  // When mounted under a launcher-owned `<ChatProvider>`, reuse that
-  // provider instead of wrapping in a second one. This lets host code
-  // freely nest `<ChatRoot>` inside `<ChatLauncher>` without losing
-  // `headerSlots` access to the same session / clearMessages / audio.
-  const ambient = useChatContextOptional();
-  if (ambient) {
-    return <ChatRootShell className={className} listClassName={listClassName} slots={slots} />;
-  }
-  if (!transport) {
-    throw new Error(
-      '<ChatRoot> requires `transport` when mounted outside a <ChatProvider>.',
-    );
-  }
-  return (
-    <ChatProvider
-      transport={transport}
-      config={config}
-      initialSessionId={initialSessionId}
-      autoCreateSession={autoCreateSession}
-      streaming={streaming}
-      audio={audio}
-      debug={debug}
-    >
-      <ChatRootShell className={className} listClassName={listClassName} slots={slots} />
-    </ChatProvider>
-  );
-}
-
-interface ChatRootShellProps {
-  className?: string;
-  listClassName?: string;
-  slots: Omit<ChatRootProps, 'transport' | 'config' | 'initialSessionId' | 'autoCreateSession' | 'streaming' | 'audio' | 'debug' | 'className' | 'listClassName'>;
-}
-
-function ChatRootShell({ className, listClassName, slots }: ChatRootShellProps) {
-  const chat = useChatContext();
-  const composer = useChatComposer({
-    onSubmit: (content, attachments) => chat.sendMessage(content, attachments),
-    disabled: chat.isStreaming,
-  });
-  const onMessagesMouseUp = useFocusOnEmptyClick({
-    enabled: slots.focusOnEmptyClick !== false,
-  });
-  // Re-focus the composer on the streaming → idle edge. Was dropped in
-  // a previous refactor — restored here so the standard chat UX (type
-  // → send → read → keep typing without clicking) works again.
-  useAutoFocusOnStreamEnd();
-  // MessageList (virtuoso) owns the scroll viewport. We talk to it
-  // via the imperative handle (scrollToBottom on JumpToLatest click)
-  // and via the `onAtBottomChange` callback (drives the pill).
-  const listRef = useRef<MessageListHandle | null>(null);
-  const [isAtBottom, setIsAtBottom] = useState(true);
-  // The id of the most-recent user-sent message. We pass it as
-  // `scrollAnchorId` to MessageList so every send re-anchors the
-  // viewport — fixes "I sent a message but the chat didn't scroll
-  // down". Recomputed lazily; the resulting id only flips when a new
-  // user message lands.
-  const lastUserMessageId = useMemo(() => {
-    const msgs = chat.messages;
-    for (let i = msgs.length - 1; i >= 0; i -= 1) {
-      if (msgs[i].role === 'user') return msgs[i].id;
-    }
-    return null;
-  }, [chat.messages]);
-  const handleStartReached = chat.hasMore && !chat.isLoadingMore
-    ? () => void chat.loadMore()
-    : undefined;
-
-  const greeting = chat.config.greeting ?? 'How can I help?';
-  const description = chat.config.description;
-  const suggestions = chat.config.suggestions;
-
-  const headerNode = slots.renderHeader ? slots.renderHeader(chat) : slots.header;
-
-  const emptyNode = slots.empty
-    ?? (slots.renderEmpty
-      ? slots.renderEmpty({ setValue: composer.setValue, focus: composer.focus })
-      : (
-          <EmptyState
-            greeting={greeting}
-            description={description}
-            suggestions={suggestions}
-            onPickSuggestion={(prompt) => {
-              composer.setValue(prompt);
-              composer.focus();
-            }}
-          />
-        ));
-
-  const renderItem = slots.renderMessage
-    ?? ((m: ChatMessage) => (
-      <MessageBubble
-        key={m.id}
-        message={m}
-        toolCallsProps={slots.toolCallsProps}
-        attachmentRenderers={slots.attachmentRenderers}
-        onAttachmentOpen={slots.onAttachmentOpen}
-        renderAfterMessage={slots.renderAfterMessage}
-        onCopy={() => copy(m.content)}
-        onRegenerate={() => void chat.regenerate(m.id)}
-        onDelete={() => chat.deleteMessage(m.id)}
-      />
-    ));
-
-  return (
-    <div className={cn('relative flex h-full min-h-0 flex-col overflow-hidden', className)}>
-      {slots.banner ?? null}
-      {headerNode ?? null}
-      <div className="relative flex min-h-0 flex-1 flex-col" onMouseUp={onMessagesMouseUp}>
-        <ErrorBanner
-          error={chat.error}
-          onDismiss={chat.error ? () => chat.clearMessages() : undefined}
-          onRetry={chat.error ? () => void chat.regenerate() : undefined}
-        />
-        <MessageList
-          ref={listRef}
-          renderItem={renderItem}
-          renderEmpty={() => <>{emptyNode}</>}
-          className={listClassName}
-          onStartReached={handleStartReached}
-          onAtBottomChange={setIsAtBottom}
-          scrollAnchorId={lastUserMessageId}
-        />
-        <div className="pointer-events-none absolute inset-x-0 bottom-2 flex justify-center">
-          {slots.jumpToLatest ?? (
-            <JumpToLatest
-              visible={!isAtBottom}
-              onClick={() => listRef.current?.scrollToBottom(true)}
-            />
-          )}
-        </div>
-      </div>
-      {!slots.hideComposer && (
-        slots.renderComposer
-          ? slots.renderComposer({
-              composer,
-              placeholder: chat.config.placeholder,
-              size: slots.composerSize,
-              showAttachmentButton: slots.showAttachmentButton,
-              onPickFiles: slots.onPickFiles,
-              toolbarStart: slots.composerToolbarStart,
-              toolbarEnd: slots.composerToolbarEnd,
-              attachmentTray: slots.composerAttachmentTray,
-            })
-          : (
-              <Composer
-                composer={composer}
-                placeholder={chat.config.placeholder}
-                showAttachmentButton={slots.showAttachmentButton}
-                onPickFiles={slots.onPickFiles}
-                toolbarStart={slots.composerToolbarStart}
-                toolbarEnd={slots.composerToolbarEnd}
-                attachmentTray={slots.composerAttachmentTray}
-                size={slots.composerSize}
-              />
-            )
-      )}
-      {slots.footer ?? null}
-    </div>
-  );
-}
-
-function copy(text: string) {
-  if (typeof navigator !== 'undefined' && navigator.clipboard) {
-    void navigator.clipboard.writeText(text);
-  }
-}
-
-// re-export for convenience: composer hook return is a common slot dependency
-export type { UseChatComposerReturn };

package/src/tools/Chat/components/Composer.tsx

@@ -1,216 +0,0 @@
-'use client';
-
-import { type ReactNode, forwardRef, useEffect, useRef } from 'react';
-import { Paperclip, Send, Square } from 'lucide-react';
-
-import { Button, Textarea } from '@djangocfg/ui-core/components';
-import { cn } from '@djangocfg/ui-core/lib';
-
-import { useChatContextOptional } from '../context';
-import type { UseChatComposerReturn } from '../hooks/useChatComposer';
-import { Attachments } from './Attachments';
-
-export type ComposerSize = 'sm' | 'md' | 'lg';
-
-export interface ComposerProps {
-  composer: UseChatComposerReturn;
-  placeholder?: string;
-  disabled?: boolean;
-  showAttachmentButton?: boolean;
-  onPickFiles?: () => void;
-  toolbarStart?: ReactNode;
-  toolbarEnd?: ReactNode;
-  attachmentTray?: ReactNode;
-  className?: string;
-  textareaClassName?: string;
-  /** Visual size — controls textarea height + button slot size.
-   *
-   * - ``sm``  — 32px slot, dense compact composer (admin sidebars, etc).
-   * - ``md``  — 36px slot, default. Same as the legacy fixed size.
-   * - ``lg``  — 48px slot, generous textarea. Use when the chat is
-   *   the page's primary surface (onboarding, support).
-   */
-  size?: ComposerSize;
-  /** Show "Stop" button instead of "Send" while streaming. */
-  isStreaming?: boolean;
-  onCancel?: () => void;
-}
-
-const SIZE_CLASSES: Record<ComposerSize, {
-  slot: string;
-  button: string;
-  iconButton: string;
-  textarea: string;
-  text: string;
-  padding: string;
-  containerPadding: string;
-}> = {
-  sm: {
-    slot: '[&>:not(textarea)]:h-8',
-    button: 'h-8 w-8',
-    iconButton: 'size-3.5',
-    textarea: 'min-h-8 max-h-48 px-3 py-1.5',
-    text: 'text-sm',
-    padding: 'gap-1.5',
-    containerPadding: 'px-2 pt-1.5 pb-[max(0.375rem,env(safe-area-inset-bottom))]',
-  },
-  md: {
-    slot: '[&>:not(textarea)]:h-9',
-    button: 'h-9 w-9',
-    iconButton: 'size-4',
-    textarea: 'min-h-9 max-h-60 px-3.5 py-2',
-    text: 'text-base sm:text-sm',
-    padding: 'gap-1.5',
-    containerPadding: 'px-2.5 pt-2 pb-[max(0.5rem,env(safe-area-inset-bottom))]',
-  },
-  lg: {
-    slot: '[&>:not(textarea)]:h-12',
-    button: 'h-12 w-12',
-    iconButton: 'size-5',
-    textarea: 'min-h-12 max-h-72 px-4 py-3',
-    text: 'text-base',
-    padding: 'gap-2',
-    containerPadding: 'px-3.5 pt-3 pb-[max(0.875rem,env(safe-area-inset-bottom))]',
-  },
-};
-
-export const Composer = forwardRef<HTMLDivElement, ComposerProps>(function Composer(
-  {
-    composer,
-    placeholder = 'Type a message...',
-    disabled,
-    showAttachmentButton = false,
-    onPickFiles,
-    toolbarStart,
-    toolbarEnd,
-    attachmentTray,
-    className,
-    textareaClassName,
-    size = 'md',
-    isStreaming: isStreamingProp,
-    onCancel: onCancelProp,
-  },
-  ref,
-) {
-  const ctx = useChatContextOptional();
-  const isStreaming = isStreamingProp ?? ctx?.isStreaming ?? false;
-  const onCancel = onCancelProp ?? ctx?.cancelStream;
-  const isDisabled = disabled ?? isStreaming;
-  const sz = SIZE_CLASSES[size];
-
-  // Register the composer's focus() with the chat context so other
-  // parts of the tree (e.g. useAutoFocusOnStreamEnd) can drive it
-  // imperatively without prop-drilling a ref. No-op when used outside
-  // a ChatProvider.
-  const register = ctx?.registerComposer;
-  const composerFocus = composer.focus;
-  const composerSetValue = composer.setValue;
-  const textareaRef = composer.textareaRef;
-  // `getValue` reads the live ref instead of closing over `composer.value`
-  // so we don't need to re-register on every keystroke. Same trick for
-  // `setValue` — handler identity stays stable across renders.
-  const getValueRef = useRef<() => string>(() => composer.value);
-  getValueRef.current = () => composer.value;
-  useEffect(() => {
-    if (!register) return;
-    register({
-      focus: composerFocus,
-      moveCursorToEnd: () => {
-        const el = textareaRef.current;
-        if (!el) return;
-        const end = el.value.length;
-        el.setSelectionRange(end, end);
-      },
-      getValue: () => getValueRef.current(),
-      setValue: composerSetValue,
-    });
-    return () => register(null);
-  }, [register, composerFocus, composerSetValue, textareaRef]);
-
-  return (
-    <div
-      ref={ref}
-      className={cn(
-        'border-t border-border bg-background/95',
-        sz.containerPadding,
-        className,
-      )}
-    >
-      {composer.attachments.length > 0 ? (
-        <div className="mb-1.5">
-          {attachmentTray ?? (
-            <Attachments
-              attachments={composer.attachments}
-              onRemove={(a) => composer.removeAttachment(a.id)}
-            />
-          )}
-        </div>
-      ) : null}
-
-      {/* Size-aware slot row. ``[&>:not(textarea)]:h-{N}`` enforces a
-       *   consistent slot height so toolbar buttons line up with the
-       *   textarea baseline. Toolbar slots that want to opt out can
-       *   pass an explicit class like `!h-auto`. */}
-      <div className={cn('flex items-end [&>:not(textarea)]:shrink-0', sz.padding, sz.slot)}>
-        {showAttachmentButton ? (
-          <Button
-            type="button"
-            variant="ghost"
-            size="icon"
-            onClick={onPickFiles}
-            aria-label="Attach files"
-            disabled={isDisabled}
-            className={sz.button}
-          >
-            <Paperclip aria-hidden className={sz.iconButton} />
-          </Button>
-        ) : null}
-
-        {toolbarStart}
-
-        <Textarea
-          {...composer.textareaProps}
-          rows={1}
-          placeholder={placeholder}
-          aria-label={placeholder}
-          aria-multiline="true"
-          disabled={isDisabled}
-          className={cn(
-            'flex-1 resize-none rounded-2xl',
-            sz.textarea,
-            sz.text,
-            textareaClassName,
-          )}
-        />
-
-        {toolbarEnd}
-
-        {isStreaming ? (
-          <Button
-            type="button"
-            variant="secondary"
-            size="icon"
-            onClick={onCancel}
-            aria-label="Stop"
-            aria-keyshortcuts="Escape"
-            className={sz.button}
-          >
-            <Square aria-hidden className={sz.iconButton} />
-          </Button>
-        ) : (
-          <Button
-            type="button"
-            size="icon"
-            onClick={() => void composer.submit()}
-            disabled={!composer.canSubmit}
-            aria-label="Send"
-            aria-keyshortcuts="Enter"
-            className={sz.button}
-          >
-            <Send aria-hidden className={sz.iconButton} />
-          </Button>
-        )}
-      </div>
-    </div>
-  );
-});

package/src/tools/Chat/hooks/useChatScroll.ts

@@ -1,145 +0,0 @@
-'use client';
-
-import { type RefObject, useCallback, useEffect, useRef, useState } from 'react';
-
-/**
- * @deprecated Plan64. As of ui-tools 2.1.369, `<MessageList>` is
- * virtualized via react-virtuoso and owns its own scroll viewport.
- * Sticky-bottom + auto-follow on streaming live inside the component;
- * use the new `MessageListProps.onAtBottomChange` prop and the
- * `MessageListHandle.scrollToBottom()` imperative method instead.
- *
- * This hook is kept for hosts that render messages outside
- * `<MessageList>` (e.g. headless story shells, custom non-virtualized
- * scroll containers). It still works against any HTMLElement scroll
- * container, but it does NOT integrate with Virtuoso — passing a
- * Virtuoso-managed element here will read garbage scroll metrics.
- */
-export interface UseChatScrollOptions {
-  containerRef: RefObject<HTMLElement | null>;
-  bottomRef: RefObject<HTMLElement | null>;
-  isStreaming?: boolean;
-  /** Distance from bottom (px) considered "at bottom". */
-  bottomThresholdPx?: number;
-  /** Bump key — increment when a new message arrives so the hook re-evaluates auto-scroll. */
-  messagesCount?: number;
-}
-
-export interface UseChatScrollReturn {
-  isAtBottom: boolean;
-  unreadCount: number;
-  scrollToBottom: (smooth?: boolean) => void;
-  resetUnread: () => void;
-}
-
-export function useChatScroll(options: UseChatScrollOptions): UseChatScrollReturn {
-  const {
-    containerRef,
-    bottomRef,
-    isStreaming = false,
-    bottomThresholdPx = 80,
-    messagesCount = 0,
-  } = options;
-
-  const [isAtBottom, setIsAtBottom] = useState(true);
-  const [unreadCount, setUnreadCount] = useState(0);
-  const lastCountRef = useRef(messagesCount);
-  const stickyRef = useRef(true);
-  const wasStreamingRef = useRef(isStreaming);
-
-  const scrollToBottom = useCallback(
-    (smooth = false) => {
-      const el = containerRef.current;
-      if (!el) return;
-      el.scrollTo({
-        top: el.scrollHeight,
-        behavior: smooth ? 'smooth' : 'auto',
-      });
-      stickyRef.current = true;
-      setIsAtBottom(true);
-      setUnreadCount(0);
-    },
-    [containerRef],
-  );
-
-  const resetUnread = useCallback(() => setUnreadCount(0), []);
-
-  // Track scroll position relative to bottom.
-  useEffect(() => {
-    const el = containerRef.current;
-    if (!el) return;
-    const onScroll = () => {
-      const distance = el.scrollHeight - el.scrollTop - el.clientHeight;
-      const atBottom = distance <= bottomThresholdPx;
-      stickyRef.current = atBottom;
-      setIsAtBottom(atBottom);
-      if (atBottom) setUnreadCount(0);
-    };
-    onScroll();
-    el.addEventListener('scroll', onScroll, { passive: true });
-    return () => {
-      el.removeEventListener('scroll', onScroll);
-    };
-  }, [containerRef, bottomThresholdPx]);
-
-  // Stick to bottom while streaming, and one extra rAF after stream ends so
-  // the final layout (markdown re-render, sources/tool-call panels) doesn't
-  // push the latest content out of view.
-  useEffect(() => {
-    const el = containerRef.current;
-    if (!el) return;
-
-    if (isStreaming) {
-      wasStreamingRef.current = true;
-      if (!stickyRef.current) return;
-      let raf = 0;
-      const tick = () => {
-        if (!stickyRef.current) return;
-        el.scrollTop = el.scrollHeight;
-        raf = requestAnimationFrame(tick);
-      };
-      raf = requestAnimationFrame(tick);
-      return () => cancelAnimationFrame(raf);
-    }
-
-    // Stream just ended — flush one more scroll on the next two frames so
-    // both markdown swap and any post-stream panel insertions are reflected.
-    if (wasStreamingRef.current && stickyRef.current) {
-      wasStreamingRef.current = false;
-      let raf1 = 0;
-      let raf2 = 0;
-      raf1 = requestAnimationFrame(() => {
-        el.scrollTop = el.scrollHeight;
-        raf2 = requestAnimationFrame(() => {
-          el.scrollTop = el.scrollHeight;
-        });
-      });
-      return () => {
-        cancelAnimationFrame(raf1);
-        cancelAnimationFrame(raf2);
-      };
-    }
-    wasStreamingRef.current = false;
-    return;
-  }, [containerRef, isStreaming]);
-
-  // On message count increase, decide whether to scroll or bump unread.
-  useEffect(() => {
-    if (messagesCount > lastCountRef.current) {
-      if (stickyRef.current) {
-        const el = containerRef.current;
-        if (el) el.scrollTop = el.scrollHeight;
-      } else {
-        setUnreadCount((n) => n + (messagesCount - lastCountRef.current));
-      }
-    }
-    lastCountRef.current = messagesCount;
-  }, [containerRef, messagesCount]);
-
-  // Watch bottom sentinel just for symmetry/future hooks.
-  useEffect(() => {
-    void bottomRef;
-  }, [bottomRef]);
-
-  return { isAtBottom, unreadCount, scrollToBottom, resetUnread };
-}

package/src/tools/Chat/types.ts

@@ -1,9 +0,0 @@
-/**
- * Backwards-compatibility re-export.
- *
- * Types live in `./types/` (one file per domain). Import directly from
- * `@djangocfg/ui-tools/Chat` in new code; this barrel exists so old
- * `import … from '.../types'` paths keep working.
- */
-
-export * from './types/index';