@sectile/vue 0.7.0 → 0.8.0

package/dist/virtual-masonry.d.ts

@@ -0,0 +1,198 @@
+import { type AllowedComponentProps, type ComponentCustomProps, type PropType, type SlotsType, type VNodeChild, type VNodeProps } from 'vue';
+import { type MasonryLayoutState, type MasonryPlacement, type MasonryPlacementPolicy } from '@sectile/virtual/masonry-layout';
+import { type VirtualInsets, type VirtualLayoutPlan, type VirtualRect, type VirtualizerErrorHandler } from '@sectile/dom/virtual';
+import { type VirtualListEstimate, type VirtualListItemAttributes, type VirtualListKeyResolver } from './internal/virtual-collection-model.js';
+import type { VirtualListSlotProps } from './internal/virtual-list.js';
+import { type ResponsiveLaneProps, type VirtualCollectionBaseProps } from './internal/virtual-collection.js';
+export interface VirtualMasonryProps<Value = unknown> extends VirtualCollectionBaseProps<Value>, ResponsiveLaneProps {
+    readonly itemSize?: number;
+    readonly estimateSize?: VirtualListEstimate<Value>;
+    readonly itemGap?: number;
+    readonly placementPolicy?: MasonryPlacementPolicy;
+}
+export type VirtualMasonryPublicProps<Value = unknown> = VirtualMasonryProps<Value> & VNodeProps & AllowedComponentProps & ComponentCustomProps & {
+    readonly onStateChange?: (state: MasonryLayoutState<string>) => unknown;
+    readonly onPlanChange?: (plan: VirtualLayoutPlan<string>) => unknown;
+    readonly onError?: VirtualizerErrorHandler;
+};
+export interface VirtualMasonrySlotProps<Value = unknown> extends VirtualListSlotProps<Value> {
+    readonly placement: MasonryPlacement<string>;
+    readonly lane: number;
+}
+export interface VirtualMasonryComponent {
+    new <Value = unknown>(props: VirtualMasonryPublicProps<Value>): {
+        $props: VirtualMasonryPublicProps<Value>;
+        $slots: {
+            default?: (props: VirtualMasonrySlotProps<Value>) => VNodeChild;
+            empty?: () => VNodeChild;
+        };
+    };
+}
+declare const VirtualMasonryRuntime: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    items: {
+        type: PropType<readonly unknown[]>;
+        required: true;
+    };
+    getKey: {
+        type: PropType<VirtualListKeyResolver<unknown>>;
+        required: true;
+    };
+    itemSize: {
+        type: NumberConstructor;
+        default: undefined;
+    };
+    estimateSize: {
+        type: PropType<VirtualListEstimate<unknown>>;
+        default: undefined;
+    };
+    laneCount: {
+        type: NumberConstructor;
+        default: undefined;
+    };
+    minLaneSize: {
+        type: NumberConstructor;
+        default: number;
+    };
+    maxLaneCount: {
+        type: NumberConstructor;
+        default: number;
+    };
+    laneGap: {
+        type: NumberConstructor;
+        default: number;
+    };
+    itemGap: {
+        type: NumberConstructor;
+        default: number;
+    };
+    placementPolicy: {
+        type: PropType<MasonryPlacementPolicy>;
+        default: string;
+    };
+    overscan: {
+        type: PropType<number | Partial<VirtualInsets>>;
+        default: number;
+    };
+    maxItems: {
+        type: NumberConstructor;
+        default: number;
+    };
+    initialViewport: {
+        type: PropType<VirtualRect>;
+        default: undefined;
+    };
+    as: {
+        type: StringConstructor;
+        default: string;
+    };
+    contentAs: {
+        type: StringConstructor;
+        default: string;
+    };
+    itemAs: {
+        type: StringConstructor;
+        default: string;
+    };
+    itemAttributes: {
+        type: PropType<VirtualListItemAttributes<unknown>>;
+        default: undefined;
+    };
+}>, () => VNodeChild, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    stateChange: (_state: MasonryLayoutState<string>) => boolean;
+    planChange: (_plan: VirtualLayoutPlan<string>) => boolean;
+    error: (_error: Parameters<VirtualizerErrorHandler>[0]) => boolean;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    items: {
+        type: PropType<readonly unknown[]>;
+        required: true;
+    };
+    getKey: {
+        type: PropType<VirtualListKeyResolver<unknown>>;
+        required: true;
+    };
+    itemSize: {
+        type: NumberConstructor;
+        default: undefined;
+    };
+    estimateSize: {
+        type: PropType<VirtualListEstimate<unknown>>;
+        default: undefined;
+    };
+    laneCount: {
+        type: NumberConstructor;
+        default: undefined;
+    };
+    minLaneSize: {
+        type: NumberConstructor;
+        default: number;
+    };
+    maxLaneCount: {
+        type: NumberConstructor;
+        default: number;
+    };
+    laneGap: {
+        type: NumberConstructor;
+        default: number;
+    };
+    itemGap: {
+        type: NumberConstructor;
+        default: number;
+    };
+    placementPolicy: {
+        type: PropType<MasonryPlacementPolicy>;
+        default: string;
+    };
+    overscan: {
+        type: PropType<number | Partial<VirtualInsets>>;
+        default: number;
+    };
+    maxItems: {
+        type: NumberConstructor;
+        default: number;
+    };
+    initialViewport: {
+        type: PropType<VirtualRect>;
+        default: undefined;
+    };
+    as: {
+        type: StringConstructor;
+        default: string;
+    };
+    contentAs: {
+        type: StringConstructor;
+        default: string;
+    };
+    itemAs: {
+        type: StringConstructor;
+        default: string;
+    };
+    itemAttributes: {
+        type: PropType<VirtualListItemAttributes<unknown>>;
+        default: undefined;
+    };
+}>> & Readonly<{
+    onError?: (_error: import("@sectile/core").SectileError<import("@sectile/virtual").VirtualErrorCode>) => any;
+    onPlanChange?: (_plan: VirtualLayoutPlan<string>) => any;
+    onStateChange?: (_state: MasonryLayoutState<string>) => any;
+}>, {
+    itemSize: number;
+    estimateSize: VirtualListEstimate<unknown>;
+    laneCount: number;
+    minLaneSize: number;
+    maxLaneCount: number;
+    laneGap: number;
+    itemGap: number;
+    placementPolicy: MasonryPlacementPolicy;
+    overscan: number | Partial<import("@sectile/core/geometry").Insets>;
+    maxItems: number;
+    initialViewport: import("@sectile/core/geometry").Rect;
+    as: string;
+    contentAs: string;
+    itemAs: string;
+    itemAttributes: VirtualListItemAttributes<unknown>;
+}, SlotsType<{
+    default: (props: VirtualMasonrySlotProps<unknown>) => VNodeChild;
+    empty: () => VNodeChild;
+}>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export declare const VirtualMasonry: typeof VirtualMasonryRuntime & VirtualMasonryComponent;
+export {};

package/dist/virtual-masonry.js

@@ -0,0 +1,221 @@
+import { defineComponent, h, nextTick, onBeforeUnmount, onMounted, shallowRef, watch } from 'vue';
+import { createExtentIndex, createUniformExtentIndex } from '@sectile/virtual/extent-index';
+import { createMasonryLayout, masonryLayoutStrategy } from '@sectile/virtual/masonry-layout';
+import { createAxisMeasurementResolver } from '@sectile/dom/virtual';
+import { VirtualizerContent, VirtualizerRoot } from './internal/virtual-core.js';
+import { assertVirtualListSizeMode, createPreparedVirtualListSequence, estimatedExtent, exactExtent, prepareVirtualList, reconcileVirtualList, requireAutomaticEstimate, requiresDOMBootstrap, updatePreparedVirtualList } from './internal/virtual-collection-model.js';
+import { createHighLevelVirtualExpose, nearlyEqual, renderCollectionBootstrapItems, renderHighLevelItems, resolveResponsiveLanes } from './internal/virtual-collection.js';
+const VirtualMasonryRuntime = /* @__PURE__ */ defineComponent({
+    name: 'SectileVirtualMasonry',
+    inheritAttrs: false,
+    props: {
+        items: { type: Array, required: true },
+        getKey: { type: Function, required: true },
+        itemSize: { type: Number, default: undefined },
+        estimateSize: { type: [Number, Function], default: undefined },
+        laneCount: { type: Number, default: undefined },
+        minLaneSize: { type: Number, default: 240 },
+        maxLaneCount: { type: Number, default: 12 },
+        laneGap: { type: Number, default: 0 },
+        itemGap: { type: Number, default: 0 },
+        placementPolicy: { type: String, default: 'shortest' },
+        overscan: { type: [Number, Object], default: 240 },
+        maxItems: { type: Number, default: 1_000_000 },
+        initialViewport: { type: Object, default: undefined },
+        as: { type: String, default: 'div' },
+        contentAs: { type: String, default: 'div' },
+        itemAs: { type: String, default: 'div' },
+        itemAttributes: { type: Function, default: undefined },
+    },
+    emits: {
+        stateChange: (_state) => true,
+        planChange: (_plan) => true,
+        error: (_error) => true,
+    },
+    slots: Object,
+    setup(props, { attrs, emit, expose, slots }) {
+        assertVirtualListSizeMode(props.itemSize, props.estimateSize);
+        const initialViewport = props.initialViewport === undefined
+            ? undefined
+            : Object.freeze({ ...props.initialViewport });
+        const prepared = shallowRef(prepareVirtualList(props.items, props.getKey));
+        const initialGeometry = resolveResponsiveLanes(initialViewport?.width ?? 0, props.laneCount, props.minLaneSize, props.maxLaneCount, props.laneGap);
+        const automaticEstimate = shallowRef();
+        const initialState = requiresDOMBootstrap(props.itemSize, props.estimateSize)
+            ? createVirtualMasonryState(prepareVirtualList([], props.getKey), [], props, initialGeometry, 0)
+            : createVirtualMasonryState(prepared.value, props.items, props, initialGeometry);
+        const activeState = shallowRef(initialState);
+        const root = shallowRef();
+        const viewportWidth = shallowRef(initialViewport?.width ?? 0);
+        const bootstrapElements = new Map();
+        let bootstrapScheduled = false;
+        let disposed = false;
+        const isBootstrapping = () => requiresDOMBootstrap(props.itemSize, props.estimateSize)
+            && automaticEstimate.value === undefined
+            && prepared.value.ids.length > 0;
+        const bootstrapItemRef = (index, value) => {
+            const element = value instanceof HTMLElement ? value : null;
+            if (element === null)
+                bootstrapElements.delete(index);
+            else {
+                bootstrapElements.set(index, element);
+                scheduleBootstrap();
+            }
+        };
+        const completeBootstrap = () => {
+            if (!isBootstrapping())
+                return;
+            const geometry = resolveResponsiveLanes(viewportWidth.value, props.laneCount, props.minLaneSize, props.maxLaneCount, props.laneGap);
+            const count = Math.min(geometry.count, prepared.value.ids.length);
+            let total = 0;
+            for (let index = 0; index < count; index += 1) {
+                const element = bootstrapElements.get(index);
+                if (element === undefined)
+                    return;
+                const height = element.getBoundingClientRect().height;
+                if (!Number.isFinite(height) || height <= 0)
+                    return;
+                total += height;
+            }
+            const estimate = total / count;
+            automaticEstimate.value = estimate;
+            bootstrapElements.clear();
+            activeState.value = createVirtualMasonryState(prepared.value, props.items, props, geometry, estimate);
+        };
+        function scheduleBootstrap() {
+            if (disposed
+                || bootstrapScheduled
+                || automaticEstimate.value !== undefined
+                || prepared.value.ids.length === 0)
+                return;
+            bootstrapScheduled = true;
+            void nextTick(() => {
+                bootstrapScheduled = false;
+                if (!disposed)
+                    completeBootstrap();
+            });
+        }
+        onMounted(scheduleBootstrap);
+        onBeforeUnmount(() => {
+            disposed = true;
+            bootstrapElements.clear();
+        });
+        const measure = props.itemSize === undefined
+            ? createAxisMeasurementResolver('vertical')
+            : undefined;
+        watch(() => [props.items, props.getKey], () => {
+            if (requiresDOMBootstrap(props.itemSize, props.estimateSize) && automaticEstimate.value === undefined) {
+                prepared.value = updatePreparedVirtualList(prepared.value, props.items, props.getKey);
+                scheduleBootstrap();
+                return;
+            }
+            const exposed = root.value;
+            if (exposed === undefined)
+                return;
+            const next = updatePreparedVirtualList(prepared.value, props.items, props.getKey);
+            const patch = reconcileVirtualList(exposed.state, next, props.items, props, automaticEstimate.value);
+            if (patch === null) {
+                prepared.value = next;
+                return;
+            }
+            const result = exposed.mutate(Object.freeze({ type: 'items', ...patch }));
+            if (result.ok)
+                prepared.value = next;
+        }, { flush: 'post' });
+        watch(() => [
+            props.laneCount,
+            props.minLaneSize,
+            props.maxLaneCount,
+            props.laneGap,
+            props.itemGap,
+            props.placementPolicy,
+            viewportWidth.value,
+        ], () => {
+            const exposed = root.value;
+            if (exposed === undefined)
+                return;
+            const geometry = resolveResponsiveLanes(viewportWidth.value, props.laneCount, props.minLaneSize, props.maxLaneCount, props.laneGap);
+            const state = exposed.state;
+            if (state.laneCount === geometry.count
+                && nearlyEqual(state.laneExtent, geometry.extent)
+                && state.laneGap === props.laneGap
+                && state.itemGap === props.itemGap
+                && state.placementPolicy === props.placementPolicy)
+                return;
+            exposed.mutate(Object.freeze({
+                type: 'geometry',
+                laneCount: geometry.count,
+                laneExtent: geometry.extent,
+                laneGap: props.laneGap,
+                itemGap: props.itemGap,
+                placementPolicy: props.placementPolicy,
+            }));
+        }, { flush: 'post' });
+        expose(createHighLevelVirtualExpose(root, initialState));
+        return () => h(VirtualizerRoot, {
+            ...attrs,
+            key: isBootstrapping() ? 'bootstrap' : 'ready',
+            ref: root,
+            defaultState: activeState.value,
+            strategy: masonryLayoutStrategy,
+            overscan: props.overscan,
+            ...(initialViewport === undefined ? {} : { initialViewport }),
+            ...(measure === undefined ? {} : {
+                measure: measure,
+            }),
+            as: props.as,
+            'data-virtual-layout': 'virtual-masonry',
+            onStateChange: (state) => emit('stateChange', state),
+            onPlanChange: (plan) => {
+                if (plan.viewport.width > 0)
+                    viewportWidth.value = plan.viewport.width;
+                emit('planChange', plan);
+            },
+            onError: (error) => emit('error', error),
+        }, {
+            default: ({ placements }) => h(VirtualizerContent, { as: props.contentAs }, {
+                default: () => isBootstrapping()
+                    ? renderCollectionBootstrapItems('virtual-masonry', prepared.value, props.items, Math.min(resolveResponsiveLanes(viewportWidth.value, props.laneCount, props.minLaneSize, props.maxLaneCount, props.laneGap).count, prepared.value.ids.length), resolveResponsiveLanes(viewportWidth.value, props.laneCount, props.minLaneSize, props.maxLaneCount, props.laneGap).extent, props.itemAs, props.itemAttributes, (value, key, index, placement) => slots['default']?.({
+                        value,
+                        key,
+                        index,
+                        placement: Object.freeze({ ...placement, lane: index }),
+                        lane: index,
+                    }), bootstrapItemRef)
+                    : renderHighLevelItems('virtual-masonry', placements, prepared.value, props.items, props.itemAs, props.itemAttributes, props.itemSize === undefined ? 'width' : 'both', (value, key, index, placement) => {
+                        const masonryPlacement = placement;
+                        return slots['default']?.({
+                            value,
+                            key,
+                            index,
+                            placement: masonryPlacement,
+                            lane: masonryPlacement.lane,
+                        });
+                    }, slots['empty']),
+            }),
+        });
+    },
+});
+export const VirtualMasonry = VirtualMasonryRuntime;
+function createVirtualMasonryState(prepared, items, props, geometry, automaticEstimate) {
+    return createMasonryLayout(createPreparedVirtualListSequence(prepared, props.maxItems), createCollectionExtents(prepared, items, props, automaticEstimate), {
+        laneCount: geometry.count,
+        laneExtent: geometry.extent,
+        laneGap: props.laneGap,
+        itemGap: props.itemGap,
+        placementPolicy: props.placementPolicy,
+        maxLanes: Math.max(geometry.count, 1_024),
+    });
+}
+function createCollectionExtents(prepared, items, props, automaticEstimate) {
+    const estimate = props.estimateSize ?? automaticEstimate;
+    const shared = props.itemSize !== undefined
+        ? exactExtent(props.itemSize)
+        : typeof estimate !== 'function'
+            ? estimatedExtent(requireAutomaticEstimate(estimate), undefined, 0)
+            : null;
+    return shared === null
+        ? createExtentIndex(prepared.ids.map((_id, index) => estimatedExtent(estimate, items[index], index)), { maxItems: props.maxItems })
+        : createUniformExtentIndex(prepared.ids.length, shared, { maxItems: props.maxItems });
+}
+//# sourceMappingURL=virtual-masonry.js.map

package/dist/virtual-masonry.js.map

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

package/dist/virtual-spatial.d.ts

@@ -0,0 +1,157 @@
+import { type AllowedComponentProps, type ComponentCustomProps, type PropType, type SlotsType, type VNodeChild, type VNodeProps } from 'vue';
+import { type SpatialLayoutState, type SpatialPlacement } from '@sectile/virtual/spatial-layout';
+import { type VirtualInsets, type VirtualLayoutPlan, type VirtualRect, type VirtualizerErrorHandler } from '@sectile/dom/virtual';
+import { type VirtualListItemAttributes, type VirtualListKeyResolver } from './internal/virtual-collection-model.js';
+import type { VirtualListSlotProps } from './internal/virtual-list.js';
+import { type VirtualCollectionBaseProps } from './internal/virtual-collection.js';
+export type VirtualSpatialRectResolver<Value> = {
+    bivarianceHack(value: Value, index: number): VirtualRect;
+}['bivarianceHack'];
+export type VirtualSpatialZIndexResolver<Value> = number | {
+    bivarianceHack(value: Value, index: number): number;
+}['bivarianceHack'];
+export interface VirtualSpatialProps<Value = unknown> extends VirtualCollectionBaseProps<Value> {
+    readonly getRect: VirtualSpatialRectResolver<Value>;
+    readonly getZIndex?: VirtualSpatialZIndexResolver<Value>;
+    readonly measureSize?: boolean;
+}
+export type VirtualSpatialPublicProps<Value = unknown> = VirtualSpatialProps<Value> & VNodeProps & AllowedComponentProps & ComponentCustomProps & {
+    readonly onStateChange?: (state: SpatialLayoutState<string>) => unknown;
+    readonly onPlanChange?: (plan: VirtualLayoutPlan<string>) => unknown;
+    readonly onError?: VirtualizerErrorHandler;
+};
+export interface VirtualSpatialSlotProps<Value = unknown> extends VirtualListSlotProps<Value> {
+    readonly placement: SpatialPlacement<string>;
+    readonly zIndex: number;
+}
+export interface VirtualSpatialComponent {
+    new <Value = unknown>(props: VirtualSpatialPublicProps<Value>): {
+        $props: VirtualSpatialPublicProps<Value>;
+        $slots: {
+            default?: (props: VirtualSpatialSlotProps<Value>) => VNodeChild;
+            empty?: () => VNodeChild;
+        };
+    };
+}
+declare const VirtualSpatialRuntime: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    items: {
+        type: PropType<readonly unknown[]>;
+        required: true;
+    };
+    getKey: {
+        type: PropType<VirtualListKeyResolver<unknown>>;
+        required: true;
+    };
+    getRect: {
+        type: PropType<VirtualSpatialRectResolver<unknown>>;
+        required: true;
+    };
+    getZIndex: {
+        type: PropType<VirtualSpatialZIndexResolver<unknown>>;
+        default: number;
+    };
+    measureSize: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    overscan: {
+        type: PropType<number | Partial<VirtualInsets>>;
+        default: number;
+    };
+    maxItems: {
+        type: NumberConstructor;
+        default: number;
+    };
+    initialViewport: {
+        type: PropType<VirtualRect>;
+        default: undefined;
+    };
+    as: {
+        type: StringConstructor;
+        default: string;
+    };
+    contentAs: {
+        type: StringConstructor;
+        default: string;
+    };
+    itemAs: {
+        type: StringConstructor;
+        default: string;
+    };
+    itemAttributes: {
+        type: PropType<VirtualListItemAttributes<unknown>>;
+        default: undefined;
+    };
+}>, () => VNodeChild, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    stateChange: (_state: SpatialLayoutState<string>) => boolean;
+    planChange: (_plan: VirtualLayoutPlan<string>) => boolean;
+    error: (_error: Parameters<VirtualizerErrorHandler>[0]) => boolean;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    items: {
+        type: PropType<readonly unknown[]>;
+        required: true;
+    };
+    getKey: {
+        type: PropType<VirtualListKeyResolver<unknown>>;
+        required: true;
+    };
+    getRect: {
+        type: PropType<VirtualSpatialRectResolver<unknown>>;
+        required: true;
+    };
+    getZIndex: {
+        type: PropType<VirtualSpatialZIndexResolver<unknown>>;
+        default: number;
+    };
+    measureSize: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    overscan: {
+        type: PropType<number | Partial<VirtualInsets>>;
+        default: number;
+    };
+    maxItems: {
+        type: NumberConstructor;
+        default: number;
+    };
+    initialViewport: {
+        type: PropType<VirtualRect>;
+        default: undefined;
+    };
+    as: {
+        type: StringConstructor;
+        default: string;
+    };
+    contentAs: {
+        type: StringConstructor;
+        default: string;
+    };
+    itemAs: {
+        type: StringConstructor;
+        default: string;
+    };
+    itemAttributes: {
+        type: PropType<VirtualListItemAttributes<unknown>>;
+        default: undefined;
+    };
+}>> & Readonly<{
+    onError?: (_error: import("@sectile/core").SectileError<import("@sectile/virtual").VirtualErrorCode>) => any;
+    onPlanChange?: (_plan: VirtualLayoutPlan<string>) => any;
+    onStateChange?: (_state: SpatialLayoutState<string>) => any;
+}>, {
+    getZIndex: VirtualSpatialZIndexResolver<unknown>;
+    measureSize: boolean;
+    overscan: number | Partial<import("@sectile/core/geometry").Insets>;
+    maxItems: number;
+    initialViewport: import("@sectile/core/geometry").Rect;
+    as: string;
+    contentAs: string;
+    itemAs: string;
+    itemAttributes: VirtualListItemAttributes<unknown>;
+}, SlotsType<{
+    default: (props: VirtualSpatialSlotProps<unknown>) => VNodeChild;
+    empty: () => VNodeChild;
+}>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export declare const VirtualSpatial: typeof VirtualSpatialRuntime & VirtualSpatialComponent;
+export {};