frontend-svelte/src/entities/Font/ui/FontVirtualList/FontVirtualList.svelte

<!--
    Component: FontVirtualList
    - Renders a virtualized list of fonts
    - Handles font registration with the manager
-->
<script lang="ts">
import {
    Skeleton,
    VirtualList,
} from '$shared/ui';
import type {
    ComponentProps,
    Snippet,
} from 'svelte';
import { fade } from 'svelte/transition';
import { getFontUrl } from '../../lib';
import {
    type FontLoadRequestConfig,
    type UnifiedFont,
    appliedFontsManager,
    fontStore,
} from '../../model';

interface Props extends
    Omit<
        ComponentProps<typeof VirtualList<UnifiedFont>>,
        'items' | 'total' | 'isLoading' | 'onVisibleItemsChange' | 'onNearBottom'
    >
{
    /**
     * Visible items callback
     */
    onVisibleItemsChange?: (items: UnifiedFont[]) => void;
    /**
     * Font weight
     */
    weight: number;
    /**
     * Skeleton snippet
     */
    skeleton?: Snippet;
}

let {
    children,
    onVisibleItemsChange,
    weight,
    skeleton,
    ...rest
}: Props = $props();

const isLoading = $derived(
    fontStore.isFetching || fontStore.isLoading,
);

let visibleFonts = $state<UnifiedFont[]>([]);

function handleInternalVisibleChange(items: UnifiedFont[]) {
    visibleFonts = items;
    // Forward the call to any external listener
    onVisibleItemsChange?.(items);
}

// Re-touch whenever visible set or weight changes — fixes weight-change gap
$effect(() => {
    const configs: FontLoadRequestConfig[] = visibleFonts.flatMap(item => {
        const url = getFontUrl(item, weight);
        if (!url) return [];
        return [{ id: item.id, name: item.name, weight, url, isVariable: item.features?.isVariable }];
    });
    if (configs.length > 0) {
        appliedFontsManager.touch(configs);
    }
});

// Pin visible fonts so the eviction policy never removes on-screen entries.
// Cleanup captures the snapshot values, so a weight change unpins the old
// weight before pinning the new one.
$effect(() => {
    const w = weight;
    const fonts = visibleFonts;
    for (const f of fonts) {
        appliedFontsManager.pin(f.id, w, f.features?.isVariable);
    }
    return () => {
        for (const f of fonts) {
            appliedFontsManager.unpin(f.id, w, f.features?.isVariable);
        }
    };
});

/**
 * Load more fonts by moving to the next page
 */
function loadMore() {
    if (
        !fontStore.pagination.hasMore
        || fontStore.isFetching
    ) {
        return;
    }
    fontStore.nextPage();
}

/**
 * Handle scroll near bottom - auto-load next page
 *
 * Triggered by VirtualList when the user scrolls within 5 items of the end
 * of the loaded items. Only fetches if there are more pages available.
 */
function handleNearBottom(_lastVisibleIndex: number) {
    const { hasMore } = fontStore.pagination;

    // VirtualList already checks if we're near the bottom of loaded items
    if (hasMore && !fontStore.isFetching) {
        loadMore();
    }
}
</script>

<div class="relative w-full h-full">
    {#if skeleton && isLoading && fontStore.fonts.length === 0}
        <!-- Show skeleton only on initial load when no fonts are loaded yet -->
        <div transition:fade={{ duration: 300 }}>
            {@render skeleton()}
        </div>
    {:else}
        <!-- VirtualList persists during pagination - no destruction/recreation -->
        <VirtualList
            items={fontStore.fonts}
            total={fontStore.pagination.total}
            isLoading={isLoading}
            onVisibleItemsChange={handleInternalVisibleChange}
            onNearBottom={handleNearBottom}
            {...rest}
        >
            {#snippet children(scope)}
                {@render children(scope)}
            {/snippet}
        </VirtualList>
    {/if}
</div>