@skygraph/core 0.0.0-placeholder.0 → 0.5.0

package/dist/types-B-rKQJ4R.d.cts

@@ -0,0 +1,35 @@
+/**
+ * Origin of a write event as seen by the runtime.
+ *
+ * Keep this union strictly runtime-level. Engine-specific tags (form, table,
+ * tree, custom) MUST live in `WriteEvent.meta`, NOT here. Adding an engine
+ * category to this union is an architecture violation — it makes core know
+ * about engines.
+ */
+type WriteSource = 'user' | 'computed' | 'transaction' | 'restore';
+interface WriteEvent {
+    path: string;
+    value: unknown;
+    oldValue: unknown;
+    source: WriteSource;
+    /**
+     * Opaque metadata bag for engines / plugins. Middleware may read/write it.
+     * Runtime itself must never branch on specific keys here.
+     */
+    meta?: Record<string, unknown>;
+}
+type NextFn = (event: WriteEvent) => void;
+type Middleware = (event: WriteEvent, next: NextFn) => void;
+interface Core {
+    get(path: string): unknown;
+    set(path: string, value: unknown): void;
+    subscribe(path: string, cb: (value: unknown) => void): () => void;
+    batch(fn: () => void): void;
+    transaction(fn: () => void): void;
+    computed(target: string, deps: string[], fn: (...values: unknown[]) => unknown): void;
+    use(middleware: Middleware): () => void;
+    snapshot(): Record<string, unknown>;
+    restore(snapshot: Record<string, unknown>): void;
+}
+
+export type { Core as C, Middleware as M, NextFn as N, WriteEvent as W, WriteSource as a };

package/dist/types-B-rKQJ4R.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Origin of a write event as seen by the runtime.
+ *
+ * Keep this union strictly runtime-level. Engine-specific tags (form, table,
+ * tree, custom) MUST live in `WriteEvent.meta`, NOT here. Adding an engine
+ * category to this union is an architecture violation — it makes core know
+ * about engines.
+ */
+type WriteSource = 'user' | 'computed' | 'transaction' | 'restore';
+interface WriteEvent {
+    path: string;
+    value: unknown;
+    oldValue: unknown;
+    source: WriteSource;
+    /**
+     * Opaque metadata bag for engines / plugins. Middleware may read/write it.
+     * Runtime itself must never branch on specific keys here.
+     */
+    meta?: Record<string, unknown>;
+}
+type NextFn = (event: WriteEvent) => void;
+type Middleware = (event: WriteEvent, next: NextFn) => void;
+interface Core {
+    get(path: string): unknown;
+    set(path: string, value: unknown): void;
+    subscribe(path: string, cb: (value: unknown) => void): () => void;
+    batch(fn: () => void): void;
+    transaction(fn: () => void): void;
+    computed(target: string, deps: string[], fn: (...values: unknown[]) => unknown): void;
+    use(middleware: Middleware): () => void;
+    snapshot(): Record<string, unknown>;
+    restore(snapshot: Record<string, unknown>): void;
+}
+
+export type { Core as C, Middleware as M, NextFn as N, WriteEvent as W, WriteSource as a };

package/dist/virtual.cjs

@@ -0,0 +1,283 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/engines/virtual/index.ts
+var virtual_exports = {};
+__export(virtual_exports, {
+  createMeasureCache: () => createMeasureCache,
+  createVirtual: () => createVirtual
+});
+module.exports = __toCommonJS(virtual_exports);
+
+// src/engines/virtual/measure.ts
+function createMeasureCache(options) {
+  let itemCount = options.itemCount;
+  let estimate = options.estimate;
+  const measured = /* @__PURE__ */ new Map();
+  let offsets = null;
+  let cachedTotal = 0;
+  const listeners = /* @__PURE__ */ new Set();
+  const getEstimate = (index) => typeof estimate === "number" ? estimate : estimate(index);
+  const getItemSize = (index) => {
+    const m = measured.get(index);
+    return m !== void 0 ? m : getEstimate(index);
+  };
+  const rebuildOffsets = () => {
+    if (offsets && offsets.length === itemCount) return;
+    const arr = new Array(itemCount);
+    let acc = 0;
+    for (let i = 0; i < itemCount; i++) {
+      arr[i] = acc;
+      acc += getItemSize(i);
+    }
+    offsets = arr;
+    cachedTotal = acc;
+  };
+  const getTotalHeight = () => {
+    rebuildOffsets();
+    return cachedTotal;
+  };
+  const getItemOffset = (index) => {
+    if (index <= 0) return 0;
+    if (index >= itemCount) return getTotalHeight();
+    rebuildOffsets();
+    return offsets[index];
+  };
+  const getItemAtOffset = (offset) => {
+    if (itemCount === 0) return 0;
+    rebuildOffsets();
+    let lo = 0;
+    let hi = itemCount - 1;
+    while (lo < hi) {
+      const mid = lo + hi + 1 >>> 1;
+      if (offsets[mid] <= offset) lo = mid;
+      else hi = mid - 1;
+    }
+    return lo;
+  };
+  const invalidate = (event) => {
+    offsets = null;
+    for (const l of listeners) l(event);
+  };
+  return {
+    get itemCount() {
+      return itemCount;
+    },
+    get measuredCount() {
+      return measured.size;
+    },
+    setItemCount(count) {
+      if (count === itemCount) return;
+      if (count < itemCount && measured.size > 0) {
+        for (const k of [...measured.keys()]) {
+          if (k >= count) measured.delete(k);
+        }
+      }
+      itemCount = count;
+      invalidate("resize");
+    },
+    setEstimate(e) {
+      estimate = e;
+      invalidate("reset");
+    },
+    setMeasuredHeight(index, height) {
+      if (index < 0 || index >= itemCount) return false;
+      if (!Number.isFinite(height) || height < 0) return false;
+      const prev = measured.get(index);
+      if (prev === height) return false;
+      measured.set(index, height);
+      invalidate("measure");
+      return true;
+    },
+    clearMeasured(index) {
+      const had = measured.delete(index);
+      if (had) invalidate("measure");
+      return had;
+    },
+    reset() {
+      if (measured.size === 0) return;
+      measured.clear();
+      invalidate("reset");
+    },
+    hasMeasured(index) {
+      return measured.has(index);
+    },
+    getMeasuredHeight(index) {
+      return measured.get(index);
+    },
+    getEstimatedSize: getEstimate,
+    getItemSize,
+    getItemOffset,
+    getItemAtOffset,
+    getTotalHeight,
+    subscribe(listener) {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    }
+  };
+}
+
+// src/engines/virtual/index.ts
+function createVirtual(options) {
+  let itemCount = options.itemCount;
+  let itemHeight = options.itemHeight;
+  const overscan = options.overscan ?? 5;
+  let cache = null;
+  const listeners = /* @__PURE__ */ new Set();
+  const ensureCache = () => {
+    if (cache) return cache;
+    cache = createMeasureCache({ itemCount, estimate: itemHeight });
+    cache.subscribe((event) => {
+      for (const l of listeners) l(event);
+    });
+    return cache;
+  };
+  const isFastPath = () => typeof itemHeight === "number" && (cache === null || cache.measuredCount === 0);
+  const getEstimate = (index) => typeof itemHeight === "number" ? itemHeight : itemHeight(index);
+  const getItemSize = (index) => {
+    if (cache) return cache.getItemSize(index);
+    return getEstimate(index);
+  };
+  const getTotalHeight = () => {
+    if (isFastPath()) return itemCount * itemHeight;
+    return ensureCache().getTotalHeight();
+  };
+  const getItemOffset = (index) => {
+    if (index <= 0) return 0;
+    if (index >= itemCount) return getTotalHeight();
+    if (isFastPath()) return index * itemHeight;
+    return ensureCache().getItemOffset(index);
+  };
+  const getItemAtOffset = (offset) => {
+    if (itemCount === 0) return 0;
+    if (isFastPath()) {
+      const h = itemHeight;
+      return Math.min(Math.floor(offset / h), itemCount - 1);
+    }
+    return ensureCache().getItemAtOffset(offset);
+  };
+  const getRange = (scrollTop, viewportHeight) => {
+    if (itemCount === 0) {
+      return { startIndex: 0, endIndex: 0, offsetTop: 0, totalHeight: 0, visibleItems: [] };
+    }
+    const total = getTotalHeight();
+    const rawStart = getItemAtOffset(scrollTop);
+    const startIndex = Math.max(0, rawStart - overscan);
+    let endIndex = rawStart;
+    let accHeight = getItemOffset(rawStart) + getItemSize(rawStart);
+    const bottomEdge = scrollTop + viewportHeight;
+    while (endIndex < itemCount - 1 && accHeight < bottomEdge) {
+      endIndex++;
+      accHeight += getItemSize(endIndex);
+    }
+    endIndex = Math.min(itemCount - 1, endIndex + overscan);
+    const visibleItems = [];
+    for (let i = startIndex; i <= endIndex; i++) {
+      visibleItems.push({
+        index: i,
+        offsetTop: getItemOffset(i),
+        height: getItemSize(i)
+      });
+    }
+    return {
+      startIndex,
+      endIndex,
+      offsetTop: getItemOffset(startIndex),
+      totalHeight: total,
+      visibleItems
+    };
+  };
+  const scrollToIndex = (index, viewportHeight, align = "start") => {
+    const clamped = Math.max(0, Math.min(index, itemCount - 1));
+    const offset = getItemOffset(clamped);
+    const h = getItemSize(clamped);
+    switch (align) {
+      case "center":
+        return Math.max(0, offset - viewportHeight / 2 + h / 2);
+      case "end":
+        return Math.max(0, offset - viewportHeight + h);
+      default:
+        return offset;
+    }
+  };
+  const emit = (event) => {
+    for (const l of listeners) l(event);
+  };
+  return {
+    get itemCount() {
+      return itemCount;
+    },
+    get totalHeight() {
+      return getTotalHeight();
+    },
+    get measuredCount() {
+      return cache?.measuredCount ?? 0;
+    },
+    setItemCount(count) {
+      if (count === itemCount) return;
+      itemCount = count;
+      if (cache) {
+        cache.setItemCount(count);
+      } else {
+        emit("resize");
+      }
+    },
+    setItemHeight(height) {
+      itemHeight = height;
+      if (cache) {
+        cache.setEstimate(height);
+      } else {
+        emit("reset");
+      }
+    },
+    setMeasuredHeight(index, height) {
+      return ensureCache().setMeasuredHeight(index, height);
+    },
+    clearMeasuredHeight(index) {
+      if (!cache) return false;
+      return cache.clearMeasured(index);
+    },
+    resetMeasurements() {
+      if (cache) cache.reset();
+    },
+    hasMeasured(index) {
+      return cache ? cache.hasMeasured(index) : false;
+    },
+    getEstimatedSize: getEstimate,
+    getItemSize,
+    getRange,
+    getItemOffset,
+    getItemAtOffset,
+    scrollToIndex,
+    subscribe(listener) {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createMeasureCache,
+  createVirtual
+});
+//# sourceMappingURL=virtual.cjs.map

package/dist/virtual.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/engines/virtual/index.ts","../src/engines/virtual/measure.ts"],"sourcesContent":["import { createMeasureCache, type MeasureCache } from './measure'\n\nexport type {\n  MeasureCache,\n  MeasureCacheEvent,\n  MeasureCacheListener,\n  MeasureCacheOptions,\n} from './measure'\nexport { createMeasureCache } from './measure'\n\nexport interface VirtualRange {\n  startIndex: number\n  endIndex: number\n  offsetTop: number\n  totalHeight: number\n  visibleItems: VirtualItem[]\n}\n\nexport interface VirtualItem {\n  index: number\n  offsetTop: number\n  height: number\n}\n\n/** Событие инвалидации, эмитимое VirtualEngine подписчикам. */\nexport type VirtualEngineEvent = 'measure' | 'reset' | 'resize'\nexport type VirtualEngineListener = (event: VirtualEngineEvent) => void\n\nexport interface VirtualEngineOptions {\n  itemCount: number\n  itemHeight: number | ((index: number) => number)\n  overscan?: number\n}\n\nexport interface VirtualEngine {\n  readonly itemCount: number\n  readonly totalHeight: number\n  /** Сколько строк прошли через `setMeasuredHeight`. */\n  readonly measuredCount: number\n\n  setItemCount(count: number): void\n  setItemHeight(height: number | ((index: number) => number)): void\n\n  /**\n   * Записать реально измеренную (через ResizeObserver) высоту строки.\n   * Возвращает `true`, если значение изменилось — полезно для контроля\n   * количества `setState` в адаптере.\n   */\n  setMeasuredHeight(index: number, height: number): boolean\n  /** Сбросить измерение для одной строки (высота вернётся к эстимейту). */\n  clearMeasuredHeight(index: number): boolean\n  /** Сбросить все измерения (например, при resize контейнера / смене темы). */\n  resetMeasurements(): void\n  /** Был ли индекс уже измерён. */\n  hasMeasured(index: number): boolean\n  /** Эстимейт высоты строки без учёта измерений. */\n  getEstimatedSize(index: number): number\n  /** Эффективная высота строки — измерение, если есть, иначе эстимейт. */\n  getItemSize(index: number): number\n\n  getRange(scrollTop: number, viewportHeight: number): VirtualRange\n  getItemOffset(index: number): number\n  getItemAtOffset(offset: number): number\n  scrollToIndex(\n    index: number,\n    viewportHeight: number,\n    align?: 'start' | 'center' | 'end',\n  ): number\n\n  /**\n   * Подписаться на инвалидации (resize / measure / reset). Вызывается\n   * только после реального изменения — повторные `setMeasuredHeight`\n   * с тем же значением событие не эмитят.\n   */\n  subscribe(listener: VirtualEngineListener): () => void\n}\n\nexport function createVirtual(options: VirtualEngineOptions): VirtualEngine {\n  let itemCount = options.itemCount\n  let itemHeight = options.itemHeight\n  const overscan = options.overscan ?? 5\n\n  // Кэш создаётся лениво — для чисто фиксированной высоты без измерений\n  // нам он не нужен, и мы сохраняем O(1) арифметику для миллионов строк.\n  let cache: MeasureCache | null = null\n  const listeners = new Set<VirtualEngineListener>()\n\n  const ensureCache = (): MeasureCache => {\n    if (cache) return cache\n    cache = createMeasureCache({ itemCount, estimate: itemHeight })\n    cache.subscribe((event) => {\n      for (const l of listeners) l(event)\n    })\n    return cache\n  }\n\n  const isFastPath = (): boolean =>\n    typeof itemHeight === 'number' && (cache === null || cache.measuredCount === 0)\n\n  const getEstimate = (index: number): number =>\n    typeof itemHeight === 'number' ? itemHeight : itemHeight(index)\n\n  const getItemSize = (index: number): number => {\n    if (cache) return cache.getItemSize(index)\n    return getEstimate(index)\n  }\n\n  const getTotalHeight = (): number => {\n    if (isFastPath()) return itemCount * (itemHeight as number)\n    return ensureCache().getTotalHeight()\n  }\n\n  const getItemOffset = (index: number): number => {\n    if (index <= 0) return 0\n    if (index >= itemCount) return getTotalHeight()\n    if (isFastPath()) return index * (itemHeight as number)\n    return ensureCache().getItemOffset(index)\n  }\n\n  const getItemAtOffset = (offset: number): number => {\n    if (itemCount === 0) return 0\n    if (isFastPath()) {\n      const h = itemHeight as number\n      return Math.min(Math.floor(offset / h), itemCount - 1)\n    }\n    return ensureCache().getItemAtOffset(offset)\n  }\n\n  const getRange = (scrollTop: number, viewportHeight: number): VirtualRange => {\n    if (itemCount === 0) {\n      return { startIndex: 0, endIndex: 0, offsetTop: 0, totalHeight: 0, visibleItems: [] }\n    }\n\n    const total = getTotalHeight()\n    const rawStart = getItemAtOffset(scrollTop)\n    const startIndex = Math.max(0, rawStart - overscan)\n\n    let endIndex = rawStart\n    let accHeight = getItemOffset(rawStart) + getItemSize(rawStart)\n    const bottomEdge = scrollTop + viewportHeight\n\n    while (endIndex < itemCount - 1 && accHeight < bottomEdge) {\n      endIndex++\n      accHeight += getItemSize(endIndex)\n    }\n    endIndex = Math.min(itemCount - 1, endIndex + overscan)\n\n    const visibleItems: VirtualItem[] = []\n    for (let i = startIndex; i <= endIndex; i++) {\n      visibleItems.push({\n        index: i,\n        offsetTop: getItemOffset(i),\n        height: getItemSize(i),\n      })\n    }\n\n    return {\n      startIndex,\n      endIndex,\n      offsetTop: getItemOffset(startIndex),\n      totalHeight: total,\n      visibleItems,\n    }\n  }\n\n  const scrollToIndex = (\n    index: number,\n    viewportHeight: number,\n    align: 'start' | 'center' | 'end' = 'start',\n  ): number => {\n    const clamped = Math.max(0, Math.min(index, itemCount - 1))\n    const offset = getItemOffset(clamped)\n    const h = getItemSize(clamped)\n\n    switch (align) {\n      case 'center':\n        return Math.max(0, offset - viewportHeight / 2 + h / 2)\n      case 'end':\n        return Math.max(0, offset - viewportHeight + h)\n      default:\n        return offset\n    }\n  }\n\n  const emit = (event: VirtualEngineEvent) => {\n    for (const l of listeners) l(event)\n  }\n\n  return {\n    get itemCount() {\n      return itemCount\n    },\n    get totalHeight() {\n      return getTotalHeight()\n    },\n    get measuredCount() {\n      return cache?.measuredCount ?? 0\n    },\n\n    setItemCount(count: number) {\n      if (count === itemCount) return\n      itemCount = count\n      if (cache) {\n        cache.setItemCount(count)\n      } else {\n        emit('resize')\n      }\n    },\n\n    setItemHeight(height: number | ((index: number) => number)) {\n      itemHeight = height\n      if (cache) {\n        cache.setEstimate(height)\n      } else {\n        emit('reset')\n      }\n    },\n\n    setMeasuredHeight(index: number, height: number) {\n      return ensureCache().setMeasuredHeight(index, height)\n    },\n\n    clearMeasuredHeight(index: number) {\n      if (!cache) return false\n      return cache.clearMeasured(index)\n    },\n\n    resetMeasurements() {\n      if (cache) cache.reset()\n    },\n\n    hasMeasured(index: number) {\n      return cache ? cache.hasMeasured(index) : false\n    },\n\n    getEstimatedSize: getEstimate,\n    getItemSize,\n\n    getRange,\n    getItemOffset,\n    getItemAtOffset,\n    scrollToIndex,\n\n    subscribe(listener: VirtualEngineListener) {\n      listeners.add(listener)\n      return () => {\n        listeners.delete(listener)\n      }\n    },\n  }\n}\n","/**\n * Кэш измерений высоты для VirtualEngine с динамической высотой строк.\n *\n * Хранит реальные измеренные высоты `Map<index, number>` поверх эстимейта.\n * Префикс-сумма (offsets) пересобирается лениво при первом запросе после\n * любой инвалидации (resize / measure / reset). Подписки нужны React-адаптеру,\n * чтобы перерисоваться, когда измерение строки изменилось.\n */\n\nexport type MeasureCacheEvent = 'measure' | 'reset' | 'resize'\nexport type MeasureCacheListener = (event: MeasureCacheEvent) => void\n\nexport interface MeasureCacheOptions {\n  itemCount: number\n  estimate: number | ((index: number) => number)\n}\n\nexport interface MeasureCache {\n  readonly itemCount: number\n  /** Сколько строк уже было измерено. */\n  readonly measuredCount: number\n\n  setItemCount(count: number): void\n  setEstimate(estimate: number | ((index: number) => number)): void\n\n  /** Записать измеренную высоту. Возвращает `true`, если значение изменилось. */\n  setMeasuredHeight(index: number, height: number): boolean\n  /** Сбросить измерение для одной строки. */\n  clearMeasured(index: number): boolean\n  /** Сбросить все измерения. */\n  reset(): void\n\n  hasMeasured(index: number): boolean\n  getMeasuredHeight(index: number): number | undefined\n\n  /** Эстимейт высоты — без учёта измерений. */\n  getEstimatedSize(index: number): number\n  /** Эффективная высота строки (измерение или эстимейт). */\n  getItemSize(index: number): number\n\n  getItemOffset(index: number): number\n  getItemAtOffset(offset: number): number\n  getTotalHeight(): number\n\n  subscribe(listener: MeasureCacheListener): () => void\n}\n\nexport function createMeasureCache(options: MeasureCacheOptions): MeasureCache {\n  let itemCount = options.itemCount\n  let estimate = options.estimate\n  const measured = new Map<number, number>()\n  let offsets: number[] | null = null\n  let cachedTotal = 0\n  const listeners = new Set<MeasureCacheListener>()\n\n  const getEstimate = (index: number): number =>\n    typeof estimate === 'number' ? estimate : estimate(index)\n\n  const getItemSize = (index: number): number => {\n    const m = measured.get(index)\n    return m !== undefined ? m : getEstimate(index)\n  }\n\n  const rebuildOffsets = () => {\n    if (offsets && offsets.length === itemCount) return\n    const arr = new Array<number>(itemCount)\n    let acc = 0\n    for (let i = 0; i < itemCount; i++) {\n      arr[i] = acc\n      acc += getItemSize(i)\n    }\n    offsets = arr\n    cachedTotal = acc\n  }\n\n  const getTotalHeight = (): number => {\n    rebuildOffsets()\n    return cachedTotal\n  }\n\n  const getItemOffset = (index: number): number => {\n    if (index <= 0) return 0\n    if (index >= itemCount) return getTotalHeight()\n    rebuildOffsets()\n    return offsets![index]!\n  }\n\n  const getItemAtOffset = (offset: number): number => {\n    if (itemCount === 0) return 0\n    rebuildOffsets()\n    let lo = 0\n    let hi = itemCount - 1\n    while (lo < hi) {\n      const mid = (lo + hi + 1) >>> 1\n      if (offsets![mid]! <= offset) lo = mid\n      else hi = mid - 1\n    }\n    return lo\n  }\n\n  const invalidate = (event: MeasureCacheEvent) => {\n    offsets = null\n    for (const l of listeners) l(event)\n  }\n\n  return {\n    get itemCount() {\n      return itemCount\n    },\n    get measuredCount() {\n      return measured.size\n    },\n\n    setItemCount(count: number) {\n      if (count === itemCount) return\n      if (count < itemCount && measured.size > 0) {\n        for (const k of [...measured.keys()]) {\n          if (k >= count) measured.delete(k)\n        }\n      }\n      itemCount = count\n      invalidate('resize')\n    },\n\n    setEstimate(e: number | ((index: number) => number)) {\n      estimate = e\n      invalidate('reset')\n    },\n\n    setMeasuredHeight(index: number, height: number): boolean {\n      if (index < 0 || index >= itemCount) return false\n      if (!Number.isFinite(height) || height < 0) return false\n      const prev = measured.get(index)\n      if (prev === height) return false\n      measured.set(index, height)\n      invalidate('measure')\n      return true\n    },\n\n    clearMeasured(index: number): boolean {\n      const had = measured.delete(index)\n      if (had) invalidate('measure')\n      return had\n    },\n\n    reset() {\n      if (measured.size === 0) return\n      measured.clear()\n      invalidate('reset')\n    },\n\n    hasMeasured(index: number) {\n      return measured.has(index)\n    },\n    getMeasuredHeight(index: number) {\n      return measured.get(index)\n    },\n\n    getEstimatedSize: getEstimate,\n    getItemSize,\n    getItemOffset,\n    getItemAtOffset,\n    getTotalHeight,\n\n    subscribe(listener: MeasureCacheListener) {\n      listeners.add(listener)\n      return () => {\n        listeners.delete(listener)\n      }\n    },\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/virtual.d.cts

@@ -0,0 +1,96 @@
+/**
+ * Кэш измерений высоты для VirtualEngine с динамической высотой строк.
+ *
+ * Хранит реальные измеренные высоты `Map<index, number>` поверх эстимейта.
+ * Префикс-сумма (offsets) пересобирается лениво при первом запросе после
+ * любой инвалидации (resize / measure / reset). Подписки нужны React-адаптеру,
+ * чтобы перерисоваться, когда измерение строки изменилось.
+ */
+type MeasureCacheEvent = 'measure' | 'reset' | 'resize';
+type MeasureCacheListener = (event: MeasureCacheEvent) => void;
+interface MeasureCacheOptions {
+    itemCount: number;
+    estimate: number | ((index: number) => number);
+}
+interface MeasureCache {
+    readonly itemCount: number;
+    /** Сколько строк уже было измерено. */
+    readonly measuredCount: number;
+    setItemCount(count: number): void;
+    setEstimate(estimate: number | ((index: number) => number)): void;
+    /** Записать измеренную высоту. Возвращает `true`, если значение изменилось. */
+    setMeasuredHeight(index: number, height: number): boolean;
+    /** Сбросить измерение для одной строки. */
+    clearMeasured(index: number): boolean;
+    /** Сбросить все измерения. */
+    reset(): void;
+    hasMeasured(index: number): boolean;
+    getMeasuredHeight(index: number): number | undefined;
+    /** Эстимейт высоты — без учёта измерений. */
+    getEstimatedSize(index: number): number;
+    /** Эффективная высота строки (измерение или эстимейт). */
+    getItemSize(index: number): number;
+    getItemOffset(index: number): number;
+    getItemAtOffset(offset: number): number;
+    getTotalHeight(): number;
+    subscribe(listener: MeasureCacheListener): () => void;
+}
+declare function createMeasureCache(options: MeasureCacheOptions): MeasureCache;
+
+interface VirtualRange {
+    startIndex: number;
+    endIndex: number;
+    offsetTop: number;
+    totalHeight: number;
+    visibleItems: VirtualItem[];
+}
+interface VirtualItem {
+    index: number;
+    offsetTop: number;
+    height: number;
+}
+/** Событие инвалидации, эмитимое VirtualEngine подписчикам. */
+type VirtualEngineEvent = 'measure' | 'reset' | 'resize';
+type VirtualEngineListener = (event: VirtualEngineEvent) => void;
+interface VirtualEngineOptions {
+    itemCount: number;
+    itemHeight: number | ((index: number) => number);
+    overscan?: number;
+}
+interface VirtualEngine {
+    readonly itemCount: number;
+    readonly totalHeight: number;
+    /** Сколько строк прошли через `setMeasuredHeight`. */
+    readonly measuredCount: number;
+    setItemCount(count: number): void;
+    setItemHeight(height: number | ((index: number) => number)): void;
+    /**
+     * Записать реально измеренную (через ResizeObserver) высоту строки.
+     * Возвращает `true`, если значение изменилось — полезно для контроля
+     * количества `setState` в адаптере.
+     */
+    setMeasuredHeight(index: number, height: number): boolean;
+    /** Сбросить измерение для одной строки (высота вернётся к эстимейту). */
+    clearMeasuredHeight(index: number): boolean;
+    /** Сбросить все измерения (например, при resize контейнера / смене темы). */
+    resetMeasurements(): void;
+    /** Был ли индекс уже измерён. */
+    hasMeasured(index: number): boolean;
+    /** Эстимейт высоты строки без учёта измерений. */
+    getEstimatedSize(index: number): number;
+    /** Эффективная высота строки — измерение, если есть, иначе эстимейт. */
+    getItemSize(index: number): number;
+    getRange(scrollTop: number, viewportHeight: number): VirtualRange;
+    getItemOffset(index: number): number;
+    getItemAtOffset(offset: number): number;
+    scrollToIndex(index: number, viewportHeight: number, align?: 'start' | 'center' | 'end'): number;
+    /**
+     * Подписаться на инвалидации (resize / measure / reset). Вызывается
+     * только после реального изменения — повторные `setMeasuredHeight`
+     * с тем же значением событие не эмитят.
+     */
+    subscribe(listener: VirtualEngineListener): () => void;
+}
+declare function createVirtual(options: VirtualEngineOptions): VirtualEngine;
+
+export { type MeasureCache, type MeasureCacheEvent, type MeasureCacheListener, type MeasureCacheOptions, type VirtualEngine, type VirtualEngineEvent, type VirtualEngineListener, type VirtualEngineOptions, type VirtualItem, type VirtualRange, createMeasureCache, createVirtual };

package/dist/virtual.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Кэш измерений высоты для VirtualEngine с динамической высотой строк.
+ *
+ * Хранит реальные измеренные высоты `Map<index, number>` поверх эстимейта.
+ * Префикс-сумма (offsets) пересобирается лениво при первом запросе после
+ * любой инвалидации (resize / measure / reset). Подписки нужны React-адаптеру,
+ * чтобы перерисоваться, когда измерение строки изменилось.
+ */
+type MeasureCacheEvent = 'measure' | 'reset' | 'resize';
+type MeasureCacheListener = (event: MeasureCacheEvent) => void;
+interface MeasureCacheOptions {
+    itemCount: number;
+    estimate: number | ((index: number) => number);
+}
+interface MeasureCache {
+    readonly itemCount: number;
+    /** Сколько строк уже было измерено. */
+    readonly measuredCount: number;
+    setItemCount(count: number): void;
+    setEstimate(estimate: number | ((index: number) => number)): void;
+    /** Записать измеренную высоту. Возвращает `true`, если значение изменилось. */
+    setMeasuredHeight(index: number, height: number): boolean;
+    /** Сбросить измерение для одной строки. */
+    clearMeasured(index: number): boolean;
+    /** Сбросить все измерения. */
+    reset(): void;
+    hasMeasured(index: number): boolean;
+    getMeasuredHeight(index: number): number | undefined;
+    /** Эстимейт высоты — без учёта измерений. */
+    getEstimatedSize(index: number): number;
+    /** Эффективная высота строки (измерение или эстимейт). */
+    getItemSize(index: number): number;
+    getItemOffset(index: number): number;
+    getItemAtOffset(offset: number): number;
+    getTotalHeight(): number;
+    subscribe(listener: MeasureCacheListener): () => void;
+}
+declare function createMeasureCache(options: MeasureCacheOptions): MeasureCache;
+
+interface VirtualRange {
+    startIndex: number;
+    endIndex: number;
+    offsetTop: number;
+    totalHeight: number;
+    visibleItems: VirtualItem[];
+}
+interface VirtualItem {
+    index: number;
+    offsetTop: number;
+    height: number;
+}
+/** Событие инвалидации, эмитимое VirtualEngine подписчикам. */
+type VirtualEngineEvent = 'measure' | 'reset' | 'resize';
+type VirtualEngineListener = (event: VirtualEngineEvent) => void;
+interface VirtualEngineOptions {
+    itemCount: number;
+    itemHeight: number | ((index: number) => number);
+    overscan?: number;
+}
+interface VirtualEngine {
+    readonly itemCount: number;
+    readonly totalHeight: number;
+    /** Сколько строк прошли через `setMeasuredHeight`. */
+    readonly measuredCount: number;
+    setItemCount(count: number): void;
+    setItemHeight(height: number | ((index: number) => number)): void;
+    /**
+     * Записать реально измеренную (через ResizeObserver) высоту строки.
+     * Возвращает `true`, если значение изменилось — полезно для контроля
+     * количества `setState` в адаптере.
+     */
+    setMeasuredHeight(index: number, height: number): boolean;
+    /** Сбросить измерение для одной строки (высота вернётся к эстимейту). */
+    clearMeasuredHeight(index: number): boolean;
+    /** Сбросить все измерения (например, при resize контейнера / смене темы). */
+    resetMeasurements(): void;
+    /** Был ли индекс уже измерён. */
+    hasMeasured(index: number): boolean;
+    /** Эстимейт высоты строки без учёта измерений. */
+    getEstimatedSize(index: number): number;
+    /** Эффективная высота строки — измерение, если есть, иначе эстимейт. */
+    getItemSize(index: number): number;
+    getRange(scrollTop: number, viewportHeight: number): VirtualRange;
+    getItemOffset(index: number): number;
+    getItemAtOffset(offset: number): number;
+    scrollToIndex(index: number, viewportHeight: number, align?: 'start' | 'center' | 'end'): number;
+    /**
+     * Подписаться на инвалидации (resize / measure / reset). Вызывается
+     * только после реального изменения — повторные `setMeasuredHeight`
+     * с тем же значением событие не эмитят.
+     */
+    subscribe(listener: VirtualEngineListener): () => void;
+}
+declare function createVirtual(options: VirtualEngineOptions): VirtualEngine;
+
+export { type MeasureCache, type MeasureCacheEvent, type MeasureCacheListener, type MeasureCacheOptions, type VirtualEngine, type VirtualEngineEvent, type VirtualEngineListener, type VirtualEngineOptions, type VirtualItem, type VirtualRange, createMeasureCache, createVirtual };

package/dist/virtual.js

@@ -0,0 +1,9 @@
+import {
+  createMeasureCache,
+  createVirtual
+} from "./chunk-IY6LJU3L.js";
+export {
+  createMeasureCache,
+  createVirtual
+};
+//# sourceMappingURL=virtual.js.map

package/dist/virtual.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}