Download tools/server/webui/src/lib/hooks/use-auto-scroll.svelte.ts from OpenTransformer/llama.cpp-prismml: direct link, hf CLI and curl.
- Browser
- Download file 4.11 kB
-
https://huggingface.co/OpenTransformer/llama.cpp-prismml/resolve/main/tools/server/webui/src/lib/hooks/use-auto-scroll.svelte.ts
- Command line
-
hf download hf://OpenTransformer/llama.cpp-prismml/tools/server/webui/src/lib/hooks/use-auto-scroll.svelte.ts
-
curl -L -o use-auto-scroll.svelte.ts https://huggingface.co/OpenTransformer/llama.cpp-prismml/resolve/main/tools/server/webui/src/lib/hooks/use-auto-scroll.svelte.ts
4.11 kB
| import { AUTO_SCROLL_AT_BOTTOM_THRESHOLD, AUTO_SCROLL_INTERVAL } from '$lib/constants/auto-scroll'; | |
| export interface AutoScrollOptions { | |
| /** Whether auto-scroll is disabled globally (e.g., from settings) */ | |
| disabled?: boolean; | |
| } | |
| /** | |
| * Creates an auto-scroll controller for a scrollable container. | |
| * | |
| * Features: | |
| * - Auto-scrolls to bottom during streaming/loading | |
| * - Stops auto-scroll when user manually scrolls up | |
| * - Resumes auto-scroll when user scrolls back to bottom | |
| */ | |
| export class AutoScrollController { | |
| private _autoScrollEnabled = $state(true); | |
| private _userScrolledUp = $state(false); | |
| private _lastScrollTop = $state(0); | |
| private _scrollInterval: ReturnType<typeof setInterval> | undefined; | |
| private _scrollTimeout: ReturnType<typeof setTimeout> | undefined; | |
| private _container: HTMLElement | undefined; | |
| private _disabled: boolean; | |
| constructor(options: AutoScrollOptions = {}) { | |
| this._disabled = options.disabled ?? false; | |
| } | |
| get autoScrollEnabled(): boolean { | |
| return this._autoScrollEnabled; | |
| } | |
| get userScrolledUp(): boolean { | |
| return this._userScrolledUp; | |
| } | |
| /** | |
| * Binds the controller to a scrollable container element. | |
| */ | |
| setContainer(container: HTMLElement | undefined): void { | |
| this._container = container; | |
| } | |
| /** | |
| * Updates the disabled state. | |
| */ | |
| setDisabled(disabled: boolean): void { | |
| this._disabled = disabled; | |
| if (disabled) { | |
| this._autoScrollEnabled = false; | |
| this.stopInterval(); | |
| } | |
| } | |
| /** | |
| * Handles scroll events to detect user scroll direction and toggle auto-scroll. | |
| */ | |
| handleScroll(): void { | |
| if (this._disabled || !this._container) return; | |
| const { scrollTop, scrollHeight, clientHeight } = this._container; | |
| const distanceFromBottom = scrollHeight - scrollTop - clientHeight; | |
| const isAtBottom = distanceFromBottom < AUTO_SCROLL_AT_BOTTOM_THRESHOLD; | |
| if (scrollTop < this._lastScrollTop && !isAtBottom) { | |
| this._userScrolledUp = true; | |
| this._autoScrollEnabled = false; | |
| } else if (isAtBottom && this._userScrolledUp) { | |
| this._userScrolledUp = false; | |
| this._autoScrollEnabled = true; | |
| } | |
| if (this._scrollTimeout) { | |
| clearTimeout(this._scrollTimeout); | |
| } | |
| this._scrollTimeout = setTimeout(() => { | |
| if (isAtBottom) { | |
| this._userScrolledUp = false; | |
| this._autoScrollEnabled = true; | |
| } | |
| }, AUTO_SCROLL_INTERVAL); | |
| this._lastScrollTop = scrollTop; | |
| } | |
| /** | |
| * Scrolls the container to the bottom. | |
| */ | |
| scrollToBottom(behavior: ScrollBehavior = 'smooth'): void { | |
| if (this._disabled || !this._container) return; | |
| this._container.scrollTo({ | |
| top: this._container.scrollHeight, | |
| behavior | |
| }); | |
| } | |
| /** | |
| * Enables auto-scroll (e.g., when user sends a message). | |
| */ | |
| enable(): void { | |
| if (this._disabled) return; | |
| this._userScrolledUp = false; | |
| this._autoScrollEnabled = true; | |
| } | |
| /** | |
| * Starts the auto-scroll interval for continuous scrolling during streaming. | |
| */ | |
| startInterval(): void { | |
| if (this._disabled || this._scrollInterval) return; | |
| this._scrollInterval = setInterval(() => { | |
| this.scrollToBottom(); | |
| }, AUTO_SCROLL_INTERVAL); | |
| } | |
| /** | |
| * Stops the auto-scroll interval. | |
| */ | |
| stopInterval(): void { | |
| if (this._scrollInterval) { | |
| clearInterval(this._scrollInterval); | |
| this._scrollInterval = undefined; | |
| } | |
| } | |
| /** | |
| * Updates the auto-scroll interval based on streaming state. | |
| * Call this in a $effect to automatically manage the interval. | |
| */ | |
| updateInterval(isStreaming: boolean): void { | |
| if (this._disabled) { | |
| this.stopInterval(); | |
| return; | |
| } | |
| if (isStreaming && this._autoScrollEnabled) { | |
| if (!this._scrollInterval) { | |
| this.startInterval(); | |
| } | |
| } else { | |
| this.stopInterval(); | |
| } | |
| } | |
| /** | |
| * Cleans up resources. Call this in onDestroy or when the component unmounts. | |
| */ | |
| destroy(): void { | |
| this.stopInterval(); | |
| if (this._scrollTimeout) { | |
| clearTimeout(this._scrollTimeout); | |
| this._scrollTimeout = undefined; | |
| } | |
| } | |
| } | |
| /** | |
| * Creates a new AutoScrollController instance. | |
| */ | |
| export function createAutoScrollController(options: AutoScrollOptions = {}): AutoScrollController { | |
| return new AutoScrollController(options); | |
| } | |