@sectile/vue 0.7.0 → 0.8.0

package/dist/internal/tabular-profile.js

@@ -0,0 +1,209 @@
+import { computed, inject, onBeforeUnmount, onMounted, provide, readonly, shallowRef, } from 'vue';
+const semantics = new WeakMap();
+const refreshers = new WeakMap();
+export function createVueProfileController(semantic) {
+    const snapshot = shallowRef(semantic.getSnapshot());
+    const refresh = () => { snapshot.value = semantic.getSnapshot(); };
+    const controller = Object.freeze({
+        snapshot: snapshot,
+        acceptedViewState: computed(() => stateOf(snapshot.value).acceptedViewState),
+        requestState: computed(() => stateOf(snapshot.value).requestState),
+        getSnapshot: () => semantic.getSnapshot(),
+        dispatch: (event, revision) => {
+            const result = semantic.dispatch(event, revision);
+            if (result.ok)
+                refresh();
+            return result;
+        },
+        synchronizeView: (response) => {
+            const result = semantic.synchronizeView(response);
+            if (result.ok)
+                refresh();
+            return result;
+        },
+        syncControlledValues: (values) => {
+            const result = semantic.syncControlledValues(values);
+            if (result.ok)
+                refresh();
+            return result;
+        },
+        requestView: () => {
+            const result = semantic.requestView();
+            if (result.ok)
+                refresh();
+            return result;
+        },
+        abandonRequest: (requestID) => {
+            const result = semantic.abandonRequest(requestID);
+            if (result.ok)
+                refresh();
+            return result;
+        },
+        subscribeCommands: (listener) => semantic.subscribeCommands(listener),
+        attachRequestExecutor: (listener) => semantic.attachRequestExecutor(listener),
+        dispose: () => semantic.dispose(),
+    });
+    semantics.set(controller, semantic);
+    refreshers.set(controller, refresh);
+    return controller;
+}
+export function refreshVueProfileController(controller) {
+    refreshers.get(controller)?.();
+}
+export function semanticController(controller) {
+    const semantic = semantics.get(controller);
+    if (semantic === undefined)
+        throw new TypeError('Unknown Vue Tabular controller.');
+    return semantic;
+}
+export function aliasVueProfileController(alias, source) {
+    const semantic = semantics.get(source);
+    const refresh = refreshers.get(source);
+    if (semantic !== undefined)
+        semantics.set(alias, semantic);
+    if (refresh !== undefined)
+        refreshers.set(alias, refresh);
+}
+export function stateOf(value) {
+    const candidate = value;
+    const state = candidate.tabular?.state ?? candidate.state;
+    if (state === undefined)
+        throw new TypeError('Invalid Tabular profile snapshot.');
+    return state;
+}
+export function provideProfile(publicKey, privateKey, controller) {
+    const connection = shallowRef(null);
+    const context = Object.freeze({
+        controller,
+        snapshot: controller.snapshot,
+        acceptedViewState: controller.acceptedViewState,
+        requestState: controller.requestState,
+        query: computed(() => stateOf(controller.snapshot.value).query),
+        rowSelection: computed(() => stateOf(controller.snapshot.value).rowSelection),
+        columnState: computed(() => stateOf(controller.snapshot.value).columnState),
+        accessState: computed(() => stateOf(controller.snapshot.value).accessState),
+        connection,
+    });
+    const publicContext = Object.freeze({
+        controller: context.controller,
+        snapshot: context.snapshot,
+        acceptedViewState: context.acceptedViewState,
+        requestState: context.requestState,
+        query: context.query,
+        rowSelection: context.rowSelection,
+        columnState: context.columnState,
+        accessState: context.accessState,
+    });
+    provide(publicKey, publicContext);
+    provide(privateKey, context);
+    return context;
+}
+export function useProfile(key, name) {
+    const context = inject(key);
+    if (context === undefined)
+        throw new TypeError(`${name} must be used inside its matching Provider.`);
+    return context;
+}
+export function useProfileSource(controller, initialResolver, options = {}) {
+    const status = shallowRef('idle');
+    const error = shallowRef(null);
+    let resolver = initialResolver;
+    let active = null;
+    let mounted = false;
+    let disposed = false;
+    let queued = null;
+    const setStatus = (next) => {
+        status.value = next;
+        options.onStatusChange?.(next);
+    };
+    const abandon = (requestID) => { controller.abandonRequest(requestID); };
+    const cancel = () => {
+        const current = active;
+        active = null;
+        queued = null;
+        if (current !== null) {
+            current.abort.abort();
+            abandon(current.requestID);
+        }
+        if (!disposed)
+            setStatus('idle');
+    };
+    const execute = (request) => {
+        if (!mounted || disposed) {
+            queued = request;
+            return;
+        }
+        if (active !== null) {
+            active.abort.abort();
+            abandon(active.requestID);
+        }
+        const abort = new AbortController();
+        active = { requestID: request.requestID, abort };
+        error.value = null;
+        setStatus('loading');
+        Promise.resolve().then(() => resolver(request, { signal: abort.signal })).then((response) => {
+            if (disposed || abort.signal.aborted || active?.requestID !== request.requestID)
+                return;
+            const synchronized = controller.synchronizeView(response);
+            if (!synchronized.ok) {
+                active = null;
+                error.value = synchronized.error;
+                setStatus('error');
+                options.onError?.(synchronized.error);
+                return;
+            }
+            active = null;
+            setStatus('success');
+        }, (reason) => {
+            if (disposed || abort.signal.aborted || active?.requestID !== request.requestID)
+                return;
+            active = null;
+            abandon(request.requestID);
+            error.value = reason;
+            setStatus('error');
+            options.onError?.(reason);
+        });
+    };
+    const attached = controller.attachRequestExecutor((command) => execute(command.request));
+    if (!attached.ok)
+        throw new TypeError(attached.error.message);
+    const releaseExecutor = attached.value;
+    const reload = () => {
+        const requested = controller.requestView();
+        if (!requested.ok)
+            throw new TypeError(requested.error.message);
+    };
+    const replaceResolver = (next) => {
+        cancel();
+        resolver = next;
+        const replaced = controller.dispatch({ type: 'replace-source' });
+        if (!replaced.ok)
+            throw new TypeError(replaced.error.message);
+    };
+    const dispose = () => {
+        if (disposed)
+            return;
+        disposed = true;
+        cancel();
+        releaseExecutor();
+    };
+    onMounted(() => {
+        mounted = true;
+        const pending = queued ?? controller.requestState.value.pendingRequest;
+        queued = null;
+        if (pending !== null)
+            execute(pending);
+    });
+    onBeforeUnmount(dispose);
+    return Object.freeze({ status: readonly(status), error: readonly(error), reload, cancel, replaceResolver, dispose });
+}
+export function controlledValues(options) {
+    return Object.freeze({
+        ...(options.query === undefined ? {} : { query: options.query.value }),
+        ...(options.rowSelection === undefined ? {} : { rowSelection: options.rowSelection.value }),
+        ...(options.columnState === undefined ? {} : { columnState: options.columnState.value }),
+        ...(options.accessState === undefined ? {} : { accessState: options.accessState.value }),
+        ...(options.expansion === undefined ? {} : { expansion: options.expansion.value }),
+    });
+}
+//# sourceMappingURL=tabular-profile.js.map

package/dist/internal/tabular-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabular-profile.js","sourceRoot":"","sources":["../../src/internal/tabular-profile.ts"],"names":[],"mappings":"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"}

package/dist/internal/virtual-collection-model.d.ts

@@ -0,0 +1,42 @@
+import { type Sequence } from '@sectile/core/sequence';
+import type { Extent } from '@sectile/virtual/extent-index';
+import type { LinearLayoutState, LinearPatch } from '@sectile/virtual/linear-layout';
+export type VirtualListKeyResolver<Value> = {
+    bivarianceHack(value: Value, index: number): string;
+}['bivarianceHack'];
+export type VirtualListEstimate<Value> = number | {
+    bivarianceHack(value: Value, index: number): number;
+}['bivarianceHack'];
+export type VirtualListItemAttributes<Value> = {
+    bivarianceHack(value: Value, index: number): Readonly<Record<string, unknown>>;
+}['bivarianceHack'];
+export interface PreparedVirtualList {
+    readonly items: readonly unknown[];
+    readonly ids: readonly string[];
+    readonly getKey: VirtualListKeyResolver<unknown>;
+    readonly change: PreparedVirtualListChange | null;
+    readonly initialIndex: ReadonlyMap<string, number> | null;
+}
+export interface PreparedVirtualListChange {
+    readonly index: number;
+    readonly deleteCount: number;
+    readonly inserted: readonly string[];
+}
+export declare function prepareVirtualList(items: readonly unknown[], getKey: VirtualListKeyResolver<unknown>): PreparedVirtualList;
+export declare function updatePreparedVirtualList(previous: PreparedVirtualList, items: readonly unknown[], getKey: VirtualListKeyResolver<unknown>): PreparedVirtualList;
+export declare function validateVirtualListKey(id: string): string;
+export declare function createPreparedVirtualListSequence(prepared: PreparedVirtualList, maxItems: number): Sequence<string>;
+export declare function isWellFormedVirtualListKey(value: string): boolean;
+export declare function reconcileVirtualList(state: Pick<LinearLayoutState<string>, 'domain' | 'extents'>, next: PreparedVirtualList, items: readonly unknown[], props: Readonly<{
+    itemSize: number | undefined;
+    estimateSize: VirtualListEstimate<unknown> | undefined;
+}>, automaticEstimate?: number): LinearPatch<string> | null;
+export declare function assertVirtualListSizeMode(itemSize: number | undefined, estimateSize: VirtualListEstimate<unknown> | undefined): void;
+export declare function initialExtent(props: Readonly<{
+    itemSize: number | undefined;
+    estimateSize: VirtualListEstimate<unknown> | undefined;
+}>, value: unknown, index: number, automaticEstimate?: number): Extent;
+export declare function requireAutomaticEstimate(estimate: VirtualListEstimate<unknown> | undefined): VirtualListEstimate<unknown>;
+export declare function requiresDOMBootstrap(itemSize: number | undefined, estimateSize: VirtualListEstimate<unknown> | undefined): boolean;
+export declare function exactExtent(value: number): Extent;
+export declare function estimatedExtent(estimate: VirtualListEstimate<unknown>, value: unknown, index: number): Extent;

package/dist/internal/virtual-collection-model.js

@@ -0,0 +1,241 @@
+import { createSequence } from '@sectile/core/sequence';
+export function prepareVirtualList(items, getKey) {
+    const ids = [];
+    const indexByID = new Map();
+    for (let index = 0; index < items.length; index += 1) {
+        const value = items[index];
+        const id = getKey(value, index);
+        if (typeof id !== 'string' || id.length === 0) {
+            throw new TypeError('VirtualList getKey must return a non-empty string.');
+        }
+        if (id.length > 1_024) {
+            throw new TypeError('VirtualList keys must contain at most 1,024 UTF-16 code units.');
+        }
+        if (!isWellFormedVirtualListKey(id)) {
+            throw new TypeError('VirtualList keys must be well-formed UTF-16 strings.');
+        }
+        if (indexByID.has(id)) {
+            throw new TypeError(`VirtualList getKey returned the duplicate key ${JSON.stringify(id)}.`);
+        }
+        ids.push(id);
+        indexByID.set(id, index);
+    }
+    return Object.freeze({
+        items,
+        ids: Object.freeze(ids),
+        getKey,
+        change: null,
+        initialIndex: indexByID,
+    });
+}
+export function updatePreparedVirtualList(previous, items, getKey) {
+    if (previous.items === items && previous.getKey === getKey)
+        return previous;
+    if (previous.getKey !== getKey) {
+        const prepared = prepareVirtualList(items, getKey);
+        let prefix = 0;
+        while (prefix < previous.ids.length
+            && prefix < prepared.ids.length
+            && previous.ids[prefix] === prepared.ids[prefix])
+            prefix += 1;
+        let suffix = 0;
+        while (suffix < previous.ids.length - prefix
+            && suffix < prepared.ids.length - prefix
+            && previous.ids[previous.ids.length - suffix - 1]
+                === prepared.ids[prepared.ids.length - suffix - 1])
+            suffix += 1;
+        if (prefix === previous.ids.length && prefix === prepared.ids.length) {
+            return Object.freeze({
+                items,
+                ids: previous.ids,
+                getKey,
+                change: null,
+                initialIndex: previous.initialIndex,
+            });
+        }
+        const inserted = Object.freeze(prepared.ids.slice(prefix, prepared.ids.length - suffix));
+        return Object.freeze({
+            ...prepared,
+            change: Object.freeze({
+                index: prefix,
+                deleteCount: previous.ids.length - prefix - suffix,
+                inserted,
+            }),
+        });
+    }
+    let prefix = 0;
+    while (prefix < previous.items.length
+        && prefix < items.length
+        && Object.is(previous.items[prefix], items[prefix]))
+        prefix += 1;
+    let suffix = 0;
+    while (suffix < previous.items.length - prefix
+        && suffix < items.length - prefix
+        && Object.is(previous.items[previous.items.length - suffix - 1], items[items.length - suffix - 1]))
+        suffix += 1;
+    if (prefix === previous.items.length && prefix === items.length) {
+        return Object.freeze({
+            items,
+            ids: previous.ids,
+            getKey,
+            change: null,
+            initialIndex: previous.initialIndex,
+        });
+    }
+    const changedEnd = items.length - suffix;
+    if (previous.items.length === items.length) {
+        let sameDomain = true;
+        for (let index = prefix; index < changedEnd; index += 1) {
+            if (validateVirtualListKey(getKey(items[index], index)) !== previous.ids[index]) {
+                sameDomain = false;
+                break;
+            }
+        }
+        if (sameDomain) {
+            return Object.freeze({
+                items,
+                ids: previous.ids,
+                getKey,
+                change: null,
+                initialIndex: previous.initialIndex,
+            });
+        }
+    }
+    const inserted = [];
+    const insertedIDs = new Set();
+    for (let index = prefix; index < changedEnd; index += 1) {
+        const id = validateVirtualListKey(getKey(items[index], index));
+        if (insertedIDs.has(id)) {
+            throw new TypeError(`VirtualList getKey returned the duplicate key ${JSON.stringify(id)}.`);
+        }
+        inserted.push(id);
+        insertedIDs.add(id);
+    }
+    const frozenInserted = Object.freeze(inserted);
+    return Object.freeze({
+        items,
+        ids: Object.freeze([
+            ...previous.ids.slice(0, prefix),
+            ...frozenInserted,
+            ...previous.ids.slice(previous.ids.length - suffix),
+        ]),
+        getKey,
+        initialIndex: null,
+        change: Object.freeze({
+            index: prefix,
+            deleteCount: previous.ids.length - prefix - suffix,
+            inserted: frozenInserted,
+        }),
+    });
+}
+export function validateVirtualListKey(id) {
+    if (typeof id !== 'string' || id.length === 0) {
+        throw new TypeError('VirtualList getKey must return a non-empty string.');
+    }
+    if (id.length > 1_024) {
+        throw new TypeError('VirtualList keys must contain at most 1,024 UTF-16 code units.');
+    }
+    if (!isWellFormedVirtualListKey(id)) {
+        throw new TypeError('VirtualList keys must be well-formed UTF-16 strings.');
+    }
+    return id;
+}
+export function createPreparedVirtualListSequence(prepared, maxItems) {
+    if (!Number.isSafeInteger(maxItems) || maxItems < 0) {
+        throw new TypeError('VirtualList maxItems must be a non-negative safe integer.');
+    }
+    if (prepared.ids.length > maxItems) {
+        throw new RangeError(`VirtualList received ${prepared.ids.length} items, exceeding maxItems ${maxItems}.`);
+    }
+    const index = prepared.initialIndex;
+    if (index === null)
+        return createSequence(prepared.ids, { maxItems, maxIDCodeUnits: 1_024 });
+    let materialized;
+    const complete = () => {
+        materialized ??= createSequence(prepared.ids, { maxItems, maxIDCodeUnits: 1_024 });
+        return materialized;
+    };
+    return Object.freeze({
+        size: prepared.ids.length,
+        ids: prepared.ids,
+        maxItems,
+        maxIDCodeUnits: 1_024,
+        at: (position) => (Number.isSafeInteger(position) && position >= 0 && position < prepared.ids.length
+            ? prepared.ids[position] ?? null
+            : null),
+        indexOf: (id) => index.get(id) ?? null,
+        contains: (id) => index.has(id),
+        compare: (left, right) => {
+            const leftIndex = index.get(left);
+            const rightIndex = index.get(right);
+            if (leftIndex === undefined || rightIndex === undefined)
+                return null;
+            return leftIndex === rightIndex ? 0 : leftIndex < rightIndex ? -1 : 1;
+        },
+        project: (predicate) => complete().project(predicate),
+        move: (current, direction, boundary, options) => complete().move(current, direction, boundary, options),
+    });
+}
+export function isWellFormedVirtualListKey(value) {
+    for (let index = 0; index < value.length; index += 1) {
+        const code = value.charCodeAt(index);
+        if (code >= 0xd800 && code <= 0xdbff) {
+            const next = value.charCodeAt(index + 1);
+            if (next < 0xdc00 || next > 0xdfff)
+                return false;
+            index += 1;
+        }
+        else if (code >= 0xdc00 && code <= 0xdfff)
+            return false;
+    }
+    return true;
+}
+export function reconcileVirtualList(state, next, items, props, automaticEstimate) {
+    const change = next.change;
+    if (change === null)
+        return null;
+    const inserted = change.inserted;
+    return Object.freeze({
+        patch: Object.freeze({
+            type: 'splice',
+            index: change.index,
+            deleteCount: change.deleteCount,
+            inserted,
+        }),
+        insertedExtents: Object.freeze(inserted.map((id, localIndex) => {
+            const nextIndex = change.index + localIndex;
+            const previousIndex = state.domain.indexOf(id);
+            return (previousIndex === null ? null : state.extents.extentAt(previousIndex))
+                ?? initialExtent(props, items[nextIndex], nextIndex, automaticEstimate);
+        })),
+    });
+}
+export function assertVirtualListSizeMode(itemSize, estimateSize) {
+    if (itemSize !== undefined && estimateSize !== undefined) {
+        throw new TypeError('VirtualList itemSize and estimateSize are mutually exclusive.');
+    }
+}
+export function initialExtent(props, value, index, automaticEstimate) {
+    return props.itemSize === undefined
+        ? estimatedExtent(requireAutomaticEstimate(props.estimateSize ?? automaticEstimate), value, index)
+        : exactExtent(props.itemSize);
+}
+export function requireAutomaticEstimate(estimate) {
+    if (estimate === undefined) {
+        throw new TypeError('Automatic virtual size must be measured before layout initialization.');
+    }
+    return estimate;
+}
+export function requiresDOMBootstrap(itemSize, estimateSize) {
+    return itemSize === undefined && estimateSize === undefined;
+}
+export function exactExtent(value) {
+    return Object.freeze({ kind: 'exact', value });
+}
+export function estimatedExtent(estimate, value, index) {
+    return Object.freeze({
+        kind: 'unknown',
+        fallback: typeof estimate === 'number' ? estimate : estimate(value, index),
+    });
+}
+//# sourceMappingURL=virtual-collection-model.js.map

package/dist/internal/virtual-collection-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual-collection-model.js","sourceRoot":"","sources":["../../src/internal/virtual-collection-model.ts"],"names":[],"mappings":"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"}

package/dist/internal/virtual-collection.d.ts

@@ -0,0 +1,38 @@
+import { type ShallowRef, type VNodeArrayChildren, type VNodeChild } from 'vue';
+import type { VirtualInsets, VirtualLayoutPlan, VirtualPlacement, VirtualRect, VirtualScrollAlignment, VirtualizerConnection } from '@sectile/dom/virtual';
+import { type VirtualizerItemSize, type VirtualizerRootExpose } from './virtual-core.js';
+import type { PreparedVirtualList, VirtualListItemAttributes, VirtualListKeyResolver } from './virtual-collection-model.js';
+export interface VirtualCollectionBaseProps<Value> {
+    readonly items: readonly Value[];
+    readonly getKey: VirtualListKeyResolver<Value>;
+    readonly overscan?: number | Partial<VirtualInsets>;
+    readonly maxItems?: number;
+    readonly initialViewport?: VirtualRect;
+    readonly as?: string;
+    readonly contentAs?: string;
+    readonly itemAs?: string;
+    readonly itemAttributes?: VirtualListItemAttributes<Value>;
+}
+export interface ResponsiveLaneProps {
+    readonly laneCount?: number;
+    readonly minLaneSize?: number;
+    readonly maxLaneCount?: number;
+    readonly laneGap?: number;
+}
+export interface VirtualCollectionExpose<State> {
+    readonly root: ShallowRef<HTMLElement | null | undefined>;
+    readonly state: State;
+    readonly plan: VirtualLayoutPlan<string> | null;
+    scrollTo(id: string, alignment?: VirtualScrollAlignment): ReturnType<VirtualizerConnection<object, string, unknown, unknown>['scrollTo']> | undefined;
+    refresh(): void;
+    flush(): ReturnType<VirtualizerConnection<object, string, unknown, unknown>['flush']> | undefined;
+}
+export interface ResponsiveLaneGeometry {
+    readonly count: number;
+    readonly extent: number;
+}
+export declare function resolveResponsiveLanes(crossExtent: number, requestedCount: number | undefined, minLaneSize: number, maxLaneCount: number, laneGap: number): ResponsiveLaneGeometry;
+export declare function renderHighLevelItems(scope: string, placements: readonly VirtualPlacement<string>[], prepared: PreparedVirtualList, items: readonly unknown[], itemAs: string, itemAttributes: VirtualListItemAttributes<unknown> | undefined, size: VirtualizerItemSize, render: (value: unknown, key: string, index: number, placement: VirtualPlacement<string>) => VNodeChild, empty: (() => VNodeChild) | undefined): VNodeArrayChildren;
+export declare function renderCollectionBootstrapItems(scope: string, prepared: PreparedVirtualList, items: readonly unknown[], count: number, width: number, itemAs: string, itemAttributes: VirtualListItemAttributes<unknown> | undefined, render: (value: unknown, key: string, index: number, placement: VirtualPlacement<string>) => VNodeChild, itemRef: (index: number, value: unknown) => void): VNodeArrayChildren;
+export declare function createHighLevelVirtualExpose<State>(root: ShallowRef<VirtualizerRootExpose | undefined>, initialState: State): VirtualCollectionExpose<State>;
+export declare function nearlyEqual(left: number, right: number): boolean;

package/dist/internal/virtual-collection.js

@@ -0,0 +1,87 @@
+import { h, shallowRef } from 'vue';
+import { VirtualizerItem } from './virtual-core.js';
+export function resolveResponsiveLanes(crossExtent, requestedCount, minLaneSize, maxLaneCount, laneGap) {
+    if (!Number.isFinite(minLaneSize) || minLaneSize <= 0)
+        throw new TypeError('minLaneSize must be a positive finite number.');
+    if (!Number.isSafeInteger(maxLaneCount) || maxLaneCount < 1)
+        throw new TypeError('maxLaneCount must be a positive safe integer.');
+    if (!Number.isFinite(laneGap) || laneGap < 0)
+        throw new TypeError('laneGap must be a non-negative finite number.');
+    if (requestedCount !== undefined && (!Number.isSafeInteger(requestedCount) || requestedCount < 1))
+        throw new TypeError('laneCount must be a positive safe integer.');
+    const available = Number.isFinite(crossExtent) && crossExtent > 0 ? crossExtent : minLaneSize;
+    const count = requestedCount ?? Math.max(1, Math.min(maxLaneCount, Math.floor((available + laneGap) / (minLaneSize + laneGap))));
+    return Object.freeze({
+        count,
+        extent: Math.max(1, (available - laneGap * (count - 1)) / count),
+    });
+}
+export function renderHighLevelItems(scope, placements, prepared, items, itemAs, itemAttributes, size, render, empty) {
+    if (prepared.ids.length === 0) {
+        const child = empty?.();
+        return child === undefined || child === null ? [] : [child];
+    }
+    return placements.flatMap((placement) => {
+        const index = placement.index;
+        if (index >= items.length || prepared.ids[index] !== placement.id)
+            return [];
+        const value = items[index];
+        const attributes = itemAttributes?.(value, index) ?? {};
+        return [h(VirtualizerItem, {
+                ...attributes,
+                key: placement.id,
+                placement,
+                size,
+                as: itemAs,
+                style: attributes['style'],
+                'data-scope': scope,
+                'data-virtual-layout': scope,
+                'data-part': 'item',
+            }, { default: () => render(value, placement.id, index, placement) })];
+    });
+}
+export function renderCollectionBootstrapItems(scope, prepared, items, count, width, itemAs, itemAttributes, render, itemRef) {
+    return Array.from({ length: Math.min(count, prepared.ids.length) }, (_unused, index) => {
+        const id = prepared.ids[index];
+        const value = items[index];
+        const attributes = itemAttributes?.(value, index) ?? {};
+        const placement = Object.freeze({
+            id,
+            index,
+            rect: Object.freeze({ x: index * width, y: 0, width, height: 0 }),
+            visible: true,
+        });
+        const rendered = render(value, id, index, placement);
+        const children = rendered === undefined || rendered === null
+            ? []
+            : Array.isArray(rendered)
+                ? rendered
+                : [rendered];
+        return h(itemAs, {
+            ...attributes,
+            key: id,
+            ref: (element) => itemRef(index, element),
+            style: [attributes['style'], { width: `${width}px` }],
+            'data-scope': scope,
+            'data-virtual-layout': scope,
+            'data-part': 'item',
+            'data-index': index,
+            'data-bootstrap': '',
+        }, children);
+    });
+}
+export function createHighLevelVirtualExpose(root, initialState) {
+    const emptyRoot = shallowRef(null);
+    return Object.freeze({
+        get root() { return root.value?.root ?? emptyRoot; },
+        get state() { return root.value?.state ?? initialState; },
+        get plan() { return root.value?.plan ?? null; },
+        scrollTo: (id, alignment) => root.value?.scrollTo(id, alignment),
+        refresh: () => root.value?.refresh(),
+        flush: () => root.value?.flush(),
+    });
+}
+export function nearlyEqual(left, right) {
+    return Math.abs(left - right) < 0.01;
+}
+//# sourceMappingURL=virtual-collection.js.map