@chenzy-design/core 0.2.1 → 0.4.0

package/dist/resizable.test.js

@@ -0,0 +1,302 @@
+import { describe, expect, it, vi } from 'vitest';
+import { createResizeDrag, computeGroupResize, clamp as clampResize, snapToGrid, snapToPoints, hasDirection, getPixelSize, judgeConstraint, adjustNewSize, } from './resizable.js';
+// ---- fake document so we can drive pointer events without a real DOM ----
+function makeFakeDoc() {
+    const listeners = new Map();
+    const doc = {
+        addEventListener(type, fn) {
+            if (!listeners.has(type))
+                listeners.set(type, new Set());
+            listeners.get(type).add(fn);
+        },
+        removeEventListener(type, fn) {
+            listeners.get(type)?.delete(fn);
+        },
+        fire(type, e) {
+            for (const fn of listeners.get(type) ?? [])
+                fn(e);
+        },
+        count(type) {
+            return listeners.get(type)?.size ?? 0;
+        },
+    };
+    return doc;
+}
+const pe = (x, y) => ({ clientX: x, clientY: y });
+describe('numeric helpers', () => {
+    it('clamp', () => {
+        expect(clampResize(5, 0, 10)).toBe(5);
+        expect(clampResize(-1, 0, 10)).toBe(0);
+        expect(clampResize(99, 0, 10)).toBe(10);
+    });
+    it('snapToGrid', () => {
+        expect(snapToGrid(23, 10)).toBe(20);
+        expect(snapToGrid(26, 10)).toBe(30);
+        expect(snapToGrid(26, 0)).toBe(26); // no snap
+    });
+    it('snapToPoints', () => {
+        expect(snapToPoints(105, [100, 200], 20)).toBe(100); // within gap
+        expect(snapToPoints(160, [100, 200], 20)).toBe(160); // outside gap -> unchanged
+        expect(snapToPoints(160, [100, 200], 0)).toBe(200); // gap 0 -> always nearest
+        expect(snapToPoints(50, undefined, 10)).toBe(50); // no targets
+        expect(snapToPoints(50, [], 10)).toBe(50); // empty targets
+    });
+    it('hasDirection', () => {
+        expect(hasDirection('topRight', 'top')).toBe(true);
+        expect(hasDirection('topRight', 'right')).toBe(true);
+        expect(hasDirection('topRight', 'left')).toBe(false);
+    });
+    it('getPixelSize parses px/%/number', () => {
+        expect(getPixelSize('120px', 500)).toBe(120);
+        expect(getPixelSize('50%', 500)).toBe(250);
+        expect(getPixelSize(80, 500)).toBe(80);
+    });
+});
+describe('createResizeDrag — single axis x (Table column case)', () => {
+    it('clamps to min and writes size on move; min covers Table MIN_COL_WIDTH', () => {
+        const doc = makeFakeDoc();
+        const sizes = [];
+        const drag = createResizeDrag({
+            axis: 'x',
+            direction: 'right',
+            getStart: () => ({ width: 100 }),
+            min: 40,
+            onMove: (s) => sizes.push(s.width),
+            ownerDocument: doc,
+        });
+        drag.start(pe(0, 0), 'right');
+        expect(doc.count('pointermove')).toBe(1);
+        doc.fire('pointermove', pe(50, 0)); // +50 => 150
+        doc.fire('pointermove', pe(-100, 0)); // -100 => clamp 40
+        expect(sizes).toEqual([150, 40]);
+        doc.fire('pointerup', pe(-100, 0));
+        expect(doc.count('pointermove')).toBe(0); // detached
+        expect(drag.isDragging()).toBe(false);
+    });
+    it('left direction grows toward negative delta', () => {
+        const doc = makeFakeDoc();
+        const sizes = [];
+        const drag = createResizeDrag({
+            axis: 'x',
+            direction: 'left',
+            getStart: () => ({ width: 100 }),
+            onMove: (s) => sizes.push(s.width),
+            ownerDocument: doc,
+        });
+        drag.start(pe(0, 0), 'left');
+        doc.fire('pointermove', pe(-30, 0)); // left: 100 - (-30) = 130
+        expect(sizes).toEqual([130]);
+    });
+    it('respects max bound', () => {
+        const doc = makeFakeDoc();
+        const sizes = [];
+        const drag = createResizeDrag({
+            axis: 'x',
+            getStart: () => ({ width: 100 }),
+            max: 120,
+            onMove: (s) => sizes.push(s.width),
+            ownerDocument: doc,
+        });
+        drag.start(pe(0, 0), 'right');
+        doc.fire('pointermove', pe(500, 0));
+        expect(sizes).toEqual([120]);
+    });
+    it('grid snaps the moving size', () => {
+        const doc = makeFakeDoc();
+        const sizes = [];
+        const drag = createResizeDrag({
+            axis: 'x',
+            getStart: () => ({ width: 100 }),
+            grid: [25, 25],
+            onMove: (s) => sizes.push(s.width),
+            ownerDocument: doc,
+        });
+        drag.start(pe(0, 0), 'right');
+        doc.fire('pointermove', pe(11, 0)); // 111 -> snap 25 -> 100
+        doc.fire('pointermove', pe(20, 0)); // 120 -> snap 25 -> 125
+        expect(sizes).toEqual([100, 125]);
+    });
+    it('scale divides the delta', () => {
+        const doc = makeFakeDoc();
+        const sizes = [];
+        const drag = createResizeDrag({
+            axis: 'x',
+            getStart: () => ({ width: 100 }),
+            scale: 2,
+            onMove: (s) => sizes.push(s.width),
+            ownerDocument: doc,
+        });
+        drag.start(pe(0, 0), 'right');
+        doc.fire('pointermove', pe(100, 0)); // 100/2 = 50 -> 150
+        expect(sizes).toEqual([150]);
+    });
+    it('snap sticks to the nearest target within snapGap', () => {
+        const doc = makeFakeDoc();
+        const sizes = [];
+        const drag = createResizeDrag({
+            axis: 'x',
+            getStart: () => ({ width: 100 }),
+            snap: { x: [100, 200, 300] },
+            snapGap: 20,
+            onMove: (s) => sizes.push(s.width),
+            ownerDocument: doc,
+        });
+        drag.start(pe(0, 0), 'right');
+        doc.fire('pointermove', pe(90, 0)); // 190 within 20 of 200 -> 200
+        doc.fire('pointermove', pe(60, 0)); // 160 not within 20 of any -> 160
+        doc.fire('pointermove', pe(105, 0)); // 205 within 20 of 200 -> 200
+        expect(sizes).toEqual([200, 160, 200]);
+    });
+    it('getBoundMax caps the size at the bound element', () => {
+        const doc = makeFakeDoc();
+        const sizes = [];
+        const drag = createResizeDrag({
+            axis: 'x',
+            getStart: () => ({ width: 100 }),
+            getBoundMax: () => ({ maxWidth: 250 }),
+            onMove: (s) => sizes.push(s.width),
+            ownerDocument: doc,
+        });
+        drag.start(pe(0, 0), 'right');
+        doc.fire('pointermove', pe(100, 0)); // 200 < 250 -> 200
+        doc.fire('pointermove', pe(300, 0)); // 400 capped at 250
+        expect(sizes).toEqual([200, 250]);
+    });
+});
+describe('createResizeDrag — lifecycle', () => {
+    it('fires onStart / onEnd and detaches on up', () => {
+        const doc = makeFakeDoc();
+        const onStart = vi.fn();
+        const onEnd = vi.fn();
+        const drag = createResizeDrag({
+            axis: 'y',
+            getStart: () => ({ height: 200 }),
+            onStart,
+            onEnd,
+            ownerDocument: doc,
+        });
+        drag.start(pe(0, 0), 'bottom');
+        expect(onStart).toHaveBeenCalledWith('bottom', expect.anything());
+        doc.fire('pointerup', pe(0, 30));
+        expect(onEnd).toHaveBeenCalledWith({ width: 0, height: 230 }, 'bottom', expect.anything());
+        expect(doc.count('pointerup')).toBe(0);
+    });
+    it('destroy() detaches leftover listeners (unmount safety net)', () => {
+        const doc = makeFakeDoc();
+        const drag = createResizeDrag({
+            axis: 'x',
+            getStart: () => ({ width: 100 }),
+            ownerDocument: doc,
+        });
+        drag.start(pe(0, 0), 'right');
+        expect(doc.count('pointermove')).toBe(1);
+        drag.destroy();
+        expect(doc.count('pointermove')).toBe(0);
+        expect(doc.count('pointerup')).toBe(0);
+    });
+    it('lockAspectRatio drives height from width on corner drag', () => {
+        const doc = makeFakeDoc();
+        const sizes = [];
+        const drag = createResizeDrag({
+            axis: 'xy',
+            getStart: () => ({ width: 100, height: 50 }), // ratio 2
+            lockAspectRatio: true,
+            onMove: (s) => sizes.push({ width: s.width, height: s.height }),
+            ownerDocument: doc,
+        });
+        drag.start(pe(0, 0), 'bottomRight');
+        doc.fire('pointermove', pe(100, 0)); // width 200 -> height 100 (ratio 2)
+        expect(sizes[0]).toEqual({ width: 200, height: 100 });
+    });
+    it('lockAspectRatioExtra offsets the driven axis (Semi lockAspectRatioExtra*)', () => {
+        const doc = makeFakeDoc();
+        const sizes = [];
+        const drag = createResizeDrag({
+            axis: 'xy',
+            getStart: () => ({ width: 100, height: 50 }),
+            lockAspectRatio: 2, // explicit ratio 2
+            lockAspectRatioExtraHeight: 10,
+            lockAspectRatioExtraWidth: 4,
+            onMove: (s) => sizes.push({ width: s.width, height: s.height }),
+            ownerDocument: doc,
+        });
+        drag.start(pe(0, 0), 'bottomRight'); // horizontal edge -> height driven from width
+        doc.fire('pointermove', pe(100, 0)); // width 200 -> height = (200-4)/2 + 10 = 108
+        expect(sizes[0]).toEqual({ width: 200, height: 108 });
+    });
+    it('boundsByDirection only caps the dragged edge axis (Semi boundsByDirection)', () => {
+        const doc = makeFakeDoc();
+        const sizes = [];
+        const drag = createResizeDrag({
+            axis: 'xy',
+            getStart: () => ({ width: 100, height: 100 }),
+            getBoundMax: () => ({ maxWidth: 150, maxHeight: 150 }),
+            boundsByDirection: true,
+            onMove: (s) => sizes.push({ width: s.width, height: s.height }),
+            ownerDocument: doc,
+        });
+        // right edge: only width is capped; height is uncapped (no top/bottom in dir)
+        drag.start(pe(0, 0), 'right');
+        doc.fire('pointermove', pe(300, 300)); // width 400 -> capped 150; height stays 100
+        expect(sizes[0]).toEqual({ width: 150, height: 100 });
+    });
+});
+describe('computeGroupResize — coupling + conservation', () => {
+    const base = {
+        direction: 'horizontal',
+        parentSize: 400,
+        lastItemSize: 200,
+        nextItemSize: 200,
+        lastItemPercent: 50,
+        nextItemPercent: 50,
+        last: {},
+        next: {},
+    };
+    it('one grows, one shrinks; sum conserved', () => {
+        const r = computeGroupResize({ ...base, delta: 40 });
+        expect(r.lastNewSize).toBe(240);
+        expect(r.nextNewSize).toBe(160);
+        expect(r.lastNewPercent + r.nextNewPercent).toBeCloseTo(100);
+    });
+    it('clamps last to min and gives the remainder to next', () => {
+        const r = computeGroupResize({
+            ...base,
+            delta: -180, // last would be 20, below min 100px
+            last: { min: '100px' },
+        });
+        expect(r.lastNewSize).toBe(100);
+        expect(r.nextNewSize).toBe(300); // 200+200-100
+        expect(r.lastNewPercent + r.nextNewPercent).toBeCloseTo(100);
+    });
+    it('clamps next to min when it would underflow', () => {
+        const r = computeGroupResize({
+            ...base,
+            delta: 180, // next would be 20, below min 100px
+            next: { min: '100px' },
+        });
+        expect(r.nextNewSize).toBe(100);
+        expect(r.lastNewSize).toBe(300);
+    });
+    it('honors percent min/max against parentSize', () => {
+        const r = computeGroupResize({
+            ...base,
+            delta: 400, // last would blow past max
+            last: { max: '75%' }, // 300px
+        });
+        expect(r.lastNewSize).toBe(300);
+        expect(r.nextNewSize).toBe(100);
+    });
+});
+describe('constraint helpers', () => {
+    it('judgeConstraint flags out-of-range', () => {
+        expect(judgeConstraint(30, '40px', '200px', 400)).toBe(true);
+        expect(judgeConstraint(300, '40px', '200px', 400)).toBe(true);
+        expect(judgeConstraint(100, '40px', '200px', 400)).toBe(false);
+    });
+    it('adjustNewSize clamps with offset', () => {
+        expect(adjustNewSize(10, '40px', '200px', 400, 5)).toBe(45);
+        expect(adjustNewSize(999, '40px', '200px', 400)).toBe(200);
+        expect(adjustNewSize(100, '40px', '200px', 400)).toBe(100);
+    });
+});
+//# sourceMappingURL=resizable.test.js.map

package/dist/resizable.test.js.map

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

package/dist/scroll-list.d.ts

@@ -1,81 +1,88 @@
 /**
- * createScrollList helpers — framework-agnostic single-column picker math.
- * Pure functions only: scroll offset ↔ selected index mapping, disabled-item
- * skipping, and keyboard target resolution. No DOM, no framework deps, no
- * internal mutable state — the render layer (svelte) owns scroll state and the
- * actual CSS scroll-snap. See specs/components/show/ScrollList.spec.md §3
- * (single-column subset; momentum/cyclic/multi-column deferred).
+ * ScrollList / ScrollItem helpers — framework-agnostic picker math.
+ *
+ * 严格对齐 Semi Design（semi-foundation/scrollList）。Semi 的 itemFoundation 是有
+ * 状态、直接操作真实 DOM 的类；本层遵循 chenzy-design headless 哲学，只抽出**纯函数**
+ * 几何 / 文案 / 缓动数学，DOM 读写（节点搬移、getBoundingClientRect）由 svelte 渲染层
+ * 用这些函数实现，无 DOM、无框架依赖、无内部可变状态。
+ *
+ * 对齐来源：
+ * - scrollItem.tsx `scrollToNode` / `scrollToCenter` → {@link centerOffset}
+ * - itemFoundation `getNearestNodeInfo`（选区中线找最近非禁用节点） → {@link nearestIndex}
+ * - scrollTo.ts（semi-animation 驱动 scrollTop） → {@link scrollFrame}
+ *   （已核 semi-animation 源码：scrollTo 传 `{duration}` 不传 easing → wrapValue 走 bezier 分支 →
+ *    getEasing(undefined)='linear'=cubic-bezier(.25,.25,.75,.75)，数学上即线性。故本层用**线性**缓动，
+ *    非弹簧、非 ease-out。）
+ * - renderItemList `transform`（选中项文案变换） → {@link resolveItemText}
+ * - constants.ts `DEFAULT_ITEM_HEIGHT=36` / `DEFAULT_SCROLL_DURATION=120`
  */
-export type ScrollListValue = string | number;
-export interface ScrollListItem {
-    value: ScrollListValue;
-    label: string;
+/** ScrollItem.mode：wheel（滚轮，居中吸附）| normal（普通列表，点击选中）。对齐 Semi strings.MODE。 */
+export type ScrollItemMode = 'wheel' | 'normal';
+/** Semi scrollList numbers 常量。 */
+export declare const SCROLL_LIST_DEFAULT_ITEM_HEIGHT = 36;
+export declare const SCROLL_LIST_DEFAULT_SCROLL_DURATION = 120;
+/**
+ * 单项数据（对齐 Semi itemFoundation `Item`）。
+ * value 任意；text 缺省时用 value 展示；transform 选中态文案变换（优先于 ScrollItem.transform）。
+ */
+export interface ScrollItemData {
+    value: unknown;
+    text?: string;
     disabled?: boolean;
+    transform?: (value: unknown, text: string) => string;
+    [x: string]: unknown;
+}
+/** onSelect 回调载荷（对齐 Semi notifySelectItem：展开 item + value + type + index）。 */
+export interface ScrollItemSelectPayload {
+    value: unknown;
+    /** 选中项在 list 中的原始索引（cycled 下已取模回 [0,len)）。 */
+    index: number;
+    /** ScrollItem.type，用于外层区分是哪一列。 */
+    type?: string | number;
+    [x: string]: unknown;
 }
-/** Map a scrollTop offset to the centered item index (clamped to range). */
-export declare function offsetToIndex(scrollTop: number, itemHeight: number, count: number): number;
-/** The scrollTop that centers a given index. */
-export declare function indexToOffset(index: number, itemHeight: number): number;
-/** Index of an item by value, or -1. */
-export declare function indexOfValue(items: readonly ScrollListItem[], value: ScrollListValue | undefined): number;
 /**
- * Resolve the nearest enabled index at or after `from` in `dir` (+1/-1).
- * If none exists in that direction, returns the original `from` unchanged.
+ * 解析一项应展示的文案（对齐 Semi renderItemList）。
+ * selected 时优先用 transform（item.transform > 公共 transform）变换，否则 text ?? String(value)。
  */
-export declare function nextEnabledIndex(items: readonly ScrollListItem[], from: number, dir: 1 | -1): number;
-/** First enabled index (for Home / value resolution), or -1 if all disabled. */
-export declare function firstEnabledIndex(items: readonly ScrollListItem[]): number;
-/** Last enabled index (for End), or -1 if all disabled. */
-export declare function lastEnabledIndex(items: readonly ScrollListItem[]): number;
-export type ScrollListKey = 'ArrowUp' | 'ArrowDown' | 'PageUp' | 'PageDown' | 'Home' | 'End';
+export declare function resolveItemText(item: ScrollItemData, selected: boolean, commonTransform?: (value: unknown, text: string) => string): string;
 /**
- * Resolve the target index for a keyboard action from the current index.
- * Returns the current index when the action can't move (boundary / all
- * neighbors disabled). `page` is how many rows PageUp/PageDown move.
+ * 把某 index 的项**居中**到视窗中线所需的 scrollTop（对齐 Semi scrollToNode）：
+ * targetTop = node.offsetTop - (wrapperHeight - itemHeight) / 2。
+ * offsetTop = index * itemHeight（含 ul 顶部 `:before` 空白，见样式）。
  */
-export declare function keyboardTarget(items: readonly ScrollListItem[], current: number, key: ScrollListKey, page?: number): number;
-/** 正取模（结果恒非负），把任意整数索引折回 [0, count)。 */
-export declare function wrapIndex(index: number, count: number): number;
+export declare function centerOffset(index: number, itemHeight: number, wrapperHeight: number, topPadding?: number): number;
 /**
- * cyclic 列的「虚拟总行数」。把真实 count 重复 repeat 份，
- * repeat 必须为奇数且 >= 3，使「中段」居中。count<=0 返回 0。
+ * 给定当前 scrollTop 与视窗高度，求中线最近的**非禁用**项索引（对齐 getNearestNodeInfo）。
+ * 中线在视窗几何正中；每项中心 = topPadding + (i + 0.5) * itemHeight - scrollTop。
+ * 返回 -1 表示无可选项（全禁用 / 空）。
  */
-export declare function cyclicVirtualCount(count: number, repeat: number): number;
+export declare function nearestIndex(scrollTop: number, itemHeight: number, wrapperHeight: number, count: number, isDisabled: (index: number) => boolean, topPadding?: number): number;
+/** 正取模：把任意整数索引折回 [0, count)（cycled 用）。对齐 Semi `index % list.length` 语义（负值也回正）。 */
+export declare function wrapIndex(index: number, count: number): number;
 /**
- * cyclic 列的「中段基准虚拟索引」：把真实索引 logical 映射到位于正中那一份的虚拟索引。
- * 例如 count=24、repeat=5 → 中段从 2*24=48 起，logical=9 → 57。
+ * cubic ease-out（先快后缓）。t ∈ [0,1]。通用缓动工具。
+ * 注意：ScrollList 落定**不**用它——Semi scrollTo 用的是线性（见 {@link scrollFrame}）。
  */
-export declare function cyclicCenterIndex(logical: number, count: number, repeat: number): number;
+export declare function easeOut(t: number): number;
 /**
- * cyclic 滚动落定后，判断是否需要把虚拟索引「重定位」回中段（避免滚出重复区边界）。
- * 返回新的虚拟索引（与传入逻辑值同余、但落在中段），渲染层据此命令式无动画跳转。
- * 当 virtualIndex 已在安全中段（距首尾各至少 count 行）时返回原值（无需跳）。
+ * 缓动滚动的单帧 scrollTop（照搬 Semi scrollTo.ts：from→to over duration，**线性**）。
+ * Semi 的 scrollTo 只传 duration 不传 easing → semi-animation 落到 'linear' bezier
+ * （cubic-bezier(.25,.25,.75,.75)，即匀速 y=x）。故此处用线性插值 `elapsed/duration`。
+ * elapsed>=duration 或 duration<=0 时返回 to（落定）。渲染层用 rAF 逐帧调用并写 el.scrollTop。
  */
-export declare function cyclicRecenter(virtualIndex: number, count: number, repeat: number): number;
-export interface MomentumStep {
-    /** 本帧后的速度（px/ms）。 */
-    velocity: number;
-    /** 本帧位移增量（px，velocity*dt 的积分近似）。 */
-    delta: number;
-    /** 速度是否已低于阈值（应停止动画进入吸附）。 */
-    done: boolean;
-}
+export declare function scrollFrame(from: number, to: number, elapsed: number, duration: number): number;
 /**
- * 推进一帧惯性：指数衰减 v' = v * decay^(dt/16.67)，位移取平均速度积分。
- * @param velocity 当前速度（px/ms，正=向下/scrollTop 增大）
- * @param dt       帧间隔（ms）
- * @param decay    每 ~16.67ms（60fps 一帧）的衰减系数，默认 0.95
- * @param minV     停止阈值（px/ms），默认 0.02
+ * cycled 头部要补多少「份」完整数据，才能让首节点越过上缓冲区顶（对齐 Semi shouldPrepend）。
+ * 照搬 Semi while 循环：`while (baseTop + itemHeight >= wrapperTop - wrapperHeight*ratio) { count++; baseTop -= listHeight }`，
+ * 参数化为相对坐标 `firstTop = firstNodeTop - wrapperTop`（首 li 顶相对视窗顶的偏移，可负），不读 DOM。
+ * ratio=缓冲区为视窗高度的倍数（init 时 2，滚动调整时 1，对齐 Semi）。
  */
-export declare function momentumStep(velocity: number, dt: number, decay?: number, minV?: number): MomentumStep;
+export declare function shouldPrepend(firstTop: number, count: number, itemHeight: number, wrapperHeight: number, ratio?: number): number;
 /**
- * 根据当前 scrollTop 与剩余速度预测「最终吸附目标行」（含一点惯性前瞻），clamp 到 [0,count)。
- * 用于释放瞬间直接算出目标行，再 smooth 吸附（比逐帧更稳，避免抖动）。
- * @param scrollTop 当前偏移
- * @param velocity  当前速度（px/ms）
- * @param itemHeight 行高
- * @param count     行数
- * @param projection 速度前瞻系数（默认 80：v*80 px 的滑行预估）
+ * cycled 尾部要补多少「份」完整数据，才能让尾节点越过下缓冲区底（对齐 Semi shouldAppend）。
+ * 照搬 Semi while 循环：`while (baseTop <= wrapperTop + wrapperHeight*ratio) { count++; baseTop += listHeight }`，
+ * 参数化为相对坐标 `lastTop = lastNodeTop - wrapperTop`（尾 li 顶相对视窗顶的偏移），不读 DOM。
  */
-export declare function projectSettleIndex(scrollTop: number, velocity: number, itemHeight: number, count: number, projection?: number): number;
+export declare function shouldAppend(lastTop: number, count: number, itemHeight: number, wrapperHeight: number, ratio?: number): number;
 //# sourceMappingURL=scroll-list.d.ts.map

package/dist/scroll-list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scroll-list.d.ts","sourceRoot":"","sources":["../src/scroll-list.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,CAAC;AAE9C,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,eAAe,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAI1F;AAED,gDAAgD;AAChD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,wCAAwC;AACxC,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,cAAc,EAAE,EAChC,KAAK,EAAE,eAAe,GAAG,SAAS,GACjC,MAAM,CAGR;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,cAAc,EAAE,EAChC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,GACV,MAAM,CAOR;AAED,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,CAK1E;AAED,2DAA2D;AAC3D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,CAKzE;AAED,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,WAAW,GACX,QAAQ,GACR,UAAU,GACV,MAAM,GACN,KAAK,CAAC;AAEV;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,SAAS,cAAc,EAAE,EAChC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,aAAa,EAClB,IAAI,SAAI,GACP,MAAM,CAmCR;AAQD,uCAAuC;AACvC,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAG9D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGxE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAKxF;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAQ1F;AAQD,MAAM,WAAW,YAAY;IAC3B,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,EACV,KAAK,SAAO,EACZ,IAAI,SAAO,GACV,YAAY,CAMd;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,UAAU,SAAK,GACd,MAAM,CAKR"}
+{"version":3,"file":"scroll-list.d.ts","sourceRoot":"","sources":["../src/scroll-list.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,8EAA8E;AAC9E,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEhD,kCAAkC;AAClC,eAAO,MAAM,+BAA+B,KAAK,CAAC;AAClD,eAAO,MAAM,mCAAmC,MAAM,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACrD,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAED,8EAA8E;AAC9E,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,cAAc,EACpB,QAAQ,EAAE,OAAO,EACjB,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,GACzD,MAAM,CAMR;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EACrB,UAAU,SAAI,GACb,MAAM,CAGR;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,EACtC,UAAU,SAAI,GACb,MAAM,CAeR;AAED,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAG9D;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAGzC;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAI/F;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EACrB,KAAK,SAAI,GACR,MAAM,CAYR;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EACrB,KAAK,SAAI,GACR,MAAM,CAYR"}