@skygraph/core 0.0.0-placeholder.0 → 0.5.0

package/dist/index.js

@@ -0,0 +1,477 @@
+import {
+  createForm
+} from "./chunk-KMGRNPLG.js";
+import {
+  computeAggregate,
+  createTable,
+  matchesColumnFilter,
+  matchesOperator,
+  resolveOperator
+} from "./chunk-ZWB7JGAJ.js";
+import {
+  createTree
+} from "./chunk-Y7FTBBYX.js";
+import {
+  createMeasureCache,
+  createVirtual
+} from "./chunk-IY6LJU3L.js";
+import {
+  aabbFromOBB,
+  createGraph,
+  floatingAnchor,
+  getBezierPath,
+  getEdgePosition,
+  getNodeIntersection,
+  inferSide,
+  nearestSide,
+  obbContainsPoint,
+  obbCorners,
+  pointsToPath,
+  pointsToRoundedPath,
+  resolveEdgeEndpoint,
+  routeOrthogonal
+} from "./chunk-7FA2TBSZ.js";
+import {
+  createCalendar,
+  detectConflicts,
+  isAvailable
+} from "./chunk-AB3RLBLW.js";
+import {
+  CALENDAR_PREFIX,
+  FORM_META_PREFIX,
+  GRAPH_PREFIX,
+  TABLE_PREFIX,
+  TREE_PREFIX,
+  listReservedPrefixes,
+  reservePrefix
+} from "./chunk-5CCD5Q4B.js";
+import {
+  Batch,
+  ComputedEngine,
+  Store,
+  SubscriptionEngine,
+  Transaction
+} from "./chunk-GEMALROQ.js";
+
+// src/Core.ts
+var CoreImpl = class {
+  store = new Store();
+  subscriptions = new SubscriptionEngine();
+  batch_ = new Batch();
+  transaction_ = new Transaction();
+  computed_ = new ComputedEngine();
+  middlewares = [];
+  // ── Middleware ──
+  use(middleware) {
+    this.middlewares.push(middleware);
+    return () => {
+      const idx = this.middlewares.indexOf(middleware);
+      if (idx !== -1) this.middlewares.splice(idx, 1);
+    };
+  }
+  dispatchWrite(event) {
+    let idx = 0;
+    const chain = (ev) => {
+      if (idx < this.middlewares.length) {
+        const mw = this.middlewares[idx++];
+        mw(ev, chain);
+      } else {
+        this.commitWrite(ev);
+      }
+    };
+    chain(event);
+  }
+  commitWrite(event) {
+    this.store.set(event.path, event.value);
+  }
+  // ── Public API ──
+  get(path) {
+    return this.store.get(path);
+  }
+  set(path, value) {
+    if (this.transaction_.isActive) {
+      this.transaction_.stage(path, value, this.store.get(path));
+      return;
+    }
+    const oldValue = this.store.get(path);
+    if (Object.is(oldValue, value)) return;
+    this.dispatchWrite({ path, value, oldValue, source: "user" });
+    const computedChanges = this.propagateComputed(/* @__PURE__ */ new Set([path]));
+    if (this.batch_.isActive) {
+      this.batch_.enqueue(path, value);
+      for (const [cp, cv] of computedChanges) {
+        this.batch_.enqueue(cp, cv);
+      }
+      return;
+    }
+    this.subscriptions.notify(path, value);
+    this.subscriptions.notifyMany(computedChanges);
+  }
+  subscribe(path, cb) {
+    return this.subscriptions.subscribe(path, cb);
+  }
+  batch(fn) {
+    this.batch_.start();
+    try {
+      fn();
+    } finally {
+      const changes = this.batch_.end();
+      if (changes) {
+        this.subscriptions.notifyMany(changes);
+      }
+    }
+  }
+  transaction(fn) {
+    this.batch_.start();
+    this.transaction_.start();
+    try {
+      fn();
+      const staged = this.transaction_.getStaged();
+      const approved = [];
+      const origCommit = this.commitWrite.bind(this);
+      this.commitWrite = (ev) => {
+        approved.push({ path: ev.path, value: ev.value });
+      };
+      try {
+        for (const write of staged) {
+          if (Object.is(write.value, write.prevValue)) continue;
+          this.dispatchWrite({
+            path: write.path,
+            value: write.value,
+            oldValue: write.prevValue,
+            source: "transaction"
+          });
+        }
+      } finally {
+        this.commitWrite = origCommit;
+      }
+      const changes = /* @__PURE__ */ new Map();
+      for (const { path, value } of approved) {
+        this.store.set(path, value);
+        changes.set(path, value);
+      }
+      this.transaction_.complete();
+      const computedChanges = this.propagateComputed(new Set(changes.keys()));
+      for (const [path, value] of changes) {
+        this.batch_.enqueue(path, value);
+      }
+      for (const [path, value] of computedChanges) {
+        this.batch_.enqueue(path, value);
+      }
+    } catch (e) {
+      this.transaction_.rollback();
+      throw e;
+    } finally {
+      const batchedChanges = this.batch_.end();
+      if (batchedChanges) {
+        this.subscriptions.notifyMany(batchedChanges);
+      }
+    }
+  }
+  computed(target, deps, fn) {
+    this.computed_.register(target, deps, fn);
+    const depValues = deps.map((d) => this.store.get(d));
+    const value = fn(...depValues);
+    const oldValue = this.store.get(target);
+    this.dispatchWrite({
+      path: target,
+      value,
+      oldValue,
+      source: "computed"
+    });
+    if (!Object.is(oldValue, value)) {
+      this.subscriptions.notify(target, value);
+    }
+  }
+  // ── Snapshot / Restore ──
+  snapshot() {
+    const result = {};
+    for (const path of this.store.paths()) {
+      result[path] = this.store.get(path);
+    }
+    return result;
+  }
+  restore(snap) {
+    this.batch_.start();
+    try {
+      for (const [path, value] of Object.entries(snap)) {
+        const oldValue = this.store.get(path);
+        if (!Object.is(oldValue, value)) {
+          this.dispatchWrite({ path, value, oldValue, source: "restore" });
+          this.batch_.enqueue(path, value);
+        }
+      }
+    } finally {
+      const changes = this.batch_.end();
+      if (changes) {
+        this.subscriptions.notifyMany(changes);
+      }
+    }
+  }
+  // ── Internal helpers ──
+  propagateComputed(changedPaths) {
+    const rawChanges = this.computed_.propagateRaw(changedPaths, this.store);
+    const dispatched = /* @__PURE__ */ new Map();
+    for (const [path, { value, oldValue }] of rawChanges) {
+      this.dispatchWrite({ path, value, oldValue, source: "computed" });
+      dispatched.set(path, value);
+    }
+    return dispatched;
+  }
+};
+function createCore() {
+  return new CoreImpl();
+}
+
+// src/middleware/logger.ts
+function loggerMiddleware(options = {}) {
+  const log = options.log ?? ((msg, ev) => console.log(msg, ev.path, ev.value));
+  const filter = options.filter;
+  return (event, next) => {
+    if (filter && !filter(event)) {
+      next(event);
+      return;
+    }
+    log(`[skygraph:${event.source}]`, event);
+    next(event);
+  };
+}
+
+// src/middleware/freeze.ts
+function freezeMiddleware(frozenPaths) {
+  return (event, next) => {
+    for (const prefix of frozenPaths) {
+      if (event.path === prefix || event.path.startsWith(prefix + ".")) {
+        return;
+      }
+    }
+    next(event);
+  };
+}
+
+// src/middleware/persistence.ts
+function persistenceMiddleware(options = {}) {
+  const storageKey = options.key ?? "skygraph:state";
+  const storage = options.storage ?? (typeof localStorage !== "undefined" ? localStorage : null);
+  const paths = options.paths;
+  const debounceMs = options.debounce ?? 100;
+  let pending = {};
+  let timer = null;
+  function flush() {
+    if (!storage) return;
+    const existing = storage.getItem(storageKey);
+    let data = {};
+    if (existing) {
+      try {
+        data = JSON.parse(existing);
+      } catch {
+      }
+    }
+    Object.assign(data, pending);
+    storage.setItem(storageKey, JSON.stringify(data));
+    pending = {};
+    timer = null;
+  }
+  return (event, next) => {
+    next(event);
+    if (paths && !paths.some((p) => event.path === p || event.path.startsWith(p + "."))) {
+      return;
+    }
+    pending[event.path] = event.value;
+    if (timer === null) {
+      timer = setTimeout(flush, debounceMs);
+    }
+  };
+}
+
+// src/middleware/validation.ts
+function validationMiddleware(optionsOrValidators) {
+  const isOptions = "validators" in optionsOrValidators;
+  const validators = isOptions ? optionsOrValidators.validators : optionsOrValidators;
+  const onReject = isOptions ? optionsOrValidators.onReject : void 0;
+  return (event, next) => {
+    const validator = validators[event.path];
+    if (validator) {
+      const result = validator(event);
+      if (result === false || typeof result === "string") {
+        onReject?.(event, typeof result === "string" ? result : "Validation failed");
+        return;
+      }
+    }
+    next(event);
+  };
+}
+
+// src/plugins/history.ts
+function createHistory(core, options = {}) {
+  const maxEntries = options.maxEntries ?? 100;
+  const groupWindow = options.groupWindow ?? 0;
+  const filter = options.filter;
+  const entries = [];
+  let cursor = -1;
+  let travelling = false;
+  let groupTimer = null;
+  let pendingPatches = [];
+  function flushGroup() {
+    if (pendingPatches.length === 0) return;
+    const entry = {
+      timestamp: Date.now(),
+      patches: [...pendingPatches]
+    };
+    pendingPatches = [];
+    if (cursor < entries.length - 1) {
+      entries.splice(cursor + 1);
+    }
+    entries.push(entry);
+    cursor++;
+    if (entries.length > maxEntries) {
+      entries.shift();
+      cursor--;
+    }
+    groupTimer = null;
+  }
+  const middleware = (event, next) => {
+    next(event);
+    if (travelling) return;
+    if (event.source === "computed") return;
+    if (filter && !filter(event)) return;
+    pendingPatches.push({
+      path: event.path,
+      value: event.value,
+      oldValue: event.oldValue
+    });
+    if (groupWindow > 0) {
+      if (groupTimer === null) {
+        groupTimer = setTimeout(flushGroup, groupWindow);
+      }
+    } else {
+      flushGroup();
+    }
+  };
+  const unsub = core.use(middleware);
+  function applyPatches(patches, direction) {
+    travelling = true;
+    try {
+      core.batch(() => {
+        if (direction === "undo") {
+          for (let i = patches.length - 1; i >= 0; i--) {
+            core.set(patches[i].path, patches[i].oldValue);
+          }
+        } else {
+          for (const patch of patches) {
+            core.set(patch.path, patch.value);
+          }
+        }
+      });
+    } finally {
+      travelling = false;
+    }
+  }
+  return {
+    get entries() {
+      return entries;
+    },
+    get cursor() {
+      return cursor;
+    },
+    get canUndo() {
+      return cursor >= 0;
+    },
+    get canRedo() {
+      return cursor < entries.length - 1;
+    },
+    undo() {
+      if (cursor < 0) return;
+      flushGroup();
+      applyPatches(entries[cursor].patches, "undo");
+      cursor--;
+    },
+    redo() {
+      if (cursor >= entries.length - 1) return;
+      flushGroup();
+      cursor++;
+      applyPatches(entries[cursor].patches, "redo");
+    },
+    jumpTo(index) {
+      if (index < -1 || index >= entries.length) return;
+      flushGroup();
+      while (cursor > index) {
+        applyPatches(entries[cursor].patches, "undo");
+        cursor--;
+      }
+      while (cursor < index) {
+        cursor++;
+        applyPatches(entries[cursor].patches, "redo");
+      }
+    },
+    clear() {
+      entries.length = 0;
+      cursor = -1;
+      pendingPatches = [];
+      if (groupTimer !== null) {
+        clearTimeout(groupTimer);
+        groupTimer = null;
+      }
+    },
+    destroy() {
+      this.clear();
+      unsub();
+    }
+  };
+}
+
+// src/typed.ts
+function createTypedCore(core) {
+  return {
+    get: core.get.bind(core),
+    set: core.set.bind(core),
+    subscribe: core.subscribe.bind(core),
+    batch: core.batch.bind(core),
+    transaction: core.transaction.bind(core),
+    computed: core.computed.bind(core),
+    raw: core
+  };
+}
+export {
+  CALENDAR_PREFIX,
+  FORM_META_PREFIX,
+  GRAPH_PREFIX,
+  TABLE_PREFIX,
+  TREE_PREFIX,
+  aabbFromOBB,
+  computeAggregate,
+  createCalendar,
+  createCore,
+  createForm,
+  createGraph,
+  createHistory,
+  createMeasureCache,
+  createTable,
+  createTree,
+  createTypedCore,
+  createVirtual,
+  detectConflicts,
+  floatingAnchor,
+  freezeMiddleware,
+  getBezierPath,
+  getEdgePosition,
+  getNodeIntersection,
+  inferSide,
+  isAvailable,
+  listReservedPrefixes,
+  loggerMiddleware,
+  matchesColumnFilter,
+  matchesOperator,
+  nearestSide,
+  obbContainsPoint,
+  obbCorners,
+  persistenceMiddleware,
+  pointsToPath,
+  pointsToRoundedPath,
+  reservePrefix,
+  resolveEdgeEndpoint,
+  resolveOperator,
+  routeOrthogonal,
+  validationMiddleware
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/Core.ts","../src/middleware/logger.ts","../src/middleware/freeze.ts","../src/middleware/persistence.ts","../src/middleware/validation.ts","../src/plugins/history.ts","../src/typed.ts"],"sourcesContent":["import { Store } from './runtime/Store'\nimport { SubscriptionEngine } from './runtime/SubscriptionEngine'\nimport { Batch } from './runtime/Batch'\nimport { Transaction } from './runtime/Transaction'\nimport { ComputedEngine } from './runtime/ComputedEngine'\nimport type { Core, Middleware, WriteEvent, NextFn } from './types'\n\nclass CoreImpl implements Core {\n  private store = new Store()\n  private subscriptions = new SubscriptionEngine()\n  private batch_ = new Batch()\n  private transaction_ = new Transaction()\n  private computed_ = new ComputedEngine()\n\n  private middlewares: Middleware[] = []\n\n  // ── Middleware ──\n\n  use(middleware: Middleware): () => void {\n    this.middlewares.push(middleware)\n    return () => {\n      const idx = this.middlewares.indexOf(middleware)\n      if (idx !== -1) this.middlewares.splice(idx, 1)\n    }\n  }\n\n  private dispatchWrite(event: WriteEvent): void {\n    let idx = 0\n    const chain: NextFn = (ev: WriteEvent) => {\n      if (idx < this.middlewares.length) {\n        const mw = this.middlewares[idx++]\n        mw(ev, chain)\n      } else {\n        this.commitWrite(ev)\n      }\n    }\n    chain(event)\n  }\n\n  private commitWrite(event: WriteEvent): void {\n    this.store.set(event.path, event.value)\n  }\n\n  // ── Public API ──\n\n  get(path: string): unknown {\n    return this.store.get(path)\n  }\n\n  set(path: string, value: unknown): void {\n    if (this.transaction_.isActive) {\n      this.transaction_.stage(path, value, this.store.get(path))\n      return\n    }\n\n    const oldValue = this.store.get(path)\n    if (Object.is(oldValue, value)) return\n\n    this.dispatchWrite({ path, value, oldValue, source: 'user' })\n\n    const computedChanges = this.propagateComputed(new Set([path]))\n\n    if (this.batch_.isActive) {\n      this.batch_.enqueue(path, value)\n      for (const [cp, cv] of computedChanges) {\n        this.batch_.enqueue(cp, cv)\n      }\n      return\n    }\n\n    this.subscriptions.notify(path, value)\n    this.subscriptions.notifyMany(computedChanges)\n  }\n\n  subscribe(path: string, cb: (value: unknown) => void): () => void {\n    return this.subscriptions.subscribe(path, cb)\n  }\n\n  batch(fn: () => void): void {\n    this.batch_.start()\n    try {\n      fn()\n    } finally {\n      const changes = this.batch_.end()\n      if (changes) {\n        this.subscriptions.notifyMany(changes)\n      }\n    }\n  }\n\n  transaction(fn: () => void): void {\n    this.batch_.start()\n    this.transaction_.start()\n    try {\n      fn()\n      const staged = this.transaction_.getStaged()\n\n      // Pass all writes through middleware first, collecting approved ones.\n      // dispatchWrite normally commits to store, so we temporarily redirect\n      // commits to a pending list and only apply them atomically if all succeed.\n      const approved: Array<{ path: string; value: unknown }> = []\n      const origCommit = this.commitWrite.bind(this)\n      this.commitWrite = (ev: WriteEvent) => {\n        approved.push({ path: ev.path, value: ev.value })\n      }\n\n      try {\n        for (const write of staged) {\n          if (Object.is(write.value, write.prevValue)) continue\n          this.dispatchWrite({\n            path: write.path,\n            value: write.value,\n            oldValue: write.prevValue,\n            source: 'transaction',\n          })\n        }\n      } finally {\n        this.commitWrite = origCommit\n      }\n\n      // All middleware passed — atomically apply to store\n      const changes = new Map<string, unknown>()\n      for (const { path, value } of approved) {\n        this.store.set(path, value)\n        changes.set(path, value)\n      }\n\n      this.transaction_.complete()\n\n      const computedChanges = this.propagateComputed(new Set(changes.keys()))\n\n      for (const [path, value] of changes) {\n        this.batch_.enqueue(path, value)\n      }\n      for (const [path, value] of computedChanges) {\n        this.batch_.enqueue(path, value)\n      }\n    } catch (e) {\n      this.transaction_.rollback()\n      throw e\n    } finally {\n      const batchedChanges = this.batch_.end()\n      if (batchedChanges) {\n        this.subscriptions.notifyMany(batchedChanges)\n      }\n    }\n  }\n\n  computed(\n    target: string,\n    deps: string[],\n    fn: (...values: unknown[]) => unknown,\n  ): void {\n    this.computed_.register(target, deps, fn)\n    const depValues = deps.map((d) => this.store.get(d))\n    const value = fn(...depValues)\n    const oldValue = this.store.get(target)\n    this.dispatchWrite({\n      path: target,\n      value,\n      oldValue,\n      source: 'computed',\n    })\n\n    if (!Object.is(oldValue, value)) {\n      this.subscriptions.notify(target, value)\n    }\n  }\n\n  // ── Snapshot / Restore ──\n\n  snapshot(): Record<string, unknown> {\n    const result: Record<string, unknown> = {}\n    for (const path of this.store.paths()) {\n      result[path] = this.store.get(path)\n    }\n    return result\n  }\n\n  restore(snap: Record<string, unknown>): void {\n    this.batch_.start()\n    try {\n      for (const [path, value] of Object.entries(snap)) {\n        const oldValue = this.store.get(path)\n        if (!Object.is(oldValue, value)) {\n          this.dispatchWrite({ path, value, oldValue, source: 'restore' })\n          this.batch_.enqueue(path, value)\n        }\n      }\n    } finally {\n      const changes = this.batch_.end()\n      if (changes) {\n        this.subscriptions.notifyMany(changes)\n      }\n    }\n  }\n\n  // ── Internal helpers ──\n\n  private propagateComputed(changedPaths: Set<string>): Map<string, unknown> {\n    const rawChanges = this.computed_.propagateRaw(changedPaths, this.store)\n    const dispatched = new Map<string, unknown>()\n\n    for (const [path, { value, oldValue }] of rawChanges) {\n      this.dispatchWrite({ path, value, oldValue, source: 'computed' })\n      dispatched.set(path, value)\n    }\n\n    return dispatched\n  }\n}\n\nexport function createCore(): Core {\n  return new CoreImpl()\n}\n","import type { Middleware, WriteEvent, NextFn } from '../types'\n\nexport interface LoggerOptions {\n  filter?: (event: WriteEvent) => boolean\n  log?: (message: string, event: WriteEvent) => void\n}\n\nexport function loggerMiddleware(options: LoggerOptions = {}): Middleware {\n  const log = options.log ?? ((msg, ev) => console.log(msg, ev.path, ev.value))\n  const filter = options.filter\n\n  return (event: WriteEvent, next: NextFn) => {\n    if (filter && !filter(event)) {\n      next(event)\n      return\n    }\n    log(`[skygraph:${event.source}]`, event)\n    next(event)\n  }\n}\n","import type { Middleware, WriteEvent, NextFn } from '../types'\n\n/**\n * Prevents writes to specified path prefixes.\n * Useful for making parts of the store read-only.\n */\nexport function freezeMiddleware(frozenPaths: string[]): Middleware {\n  return (event: WriteEvent, next: NextFn) => {\n    for (const prefix of frozenPaths) {\n      if (event.path === prefix || event.path.startsWith(prefix + '.')) {\n        return\n      }\n    }\n    next(event)\n  }\n}\n","import type { Middleware, WriteEvent, NextFn } from '../types'\n\nexport interface PersistenceOptions {\n  key?: string\n  paths?: string[]\n  storage?: {\n    getItem(key: string): string | null\n    setItem(key: string, value: string): void\n  }\n  debounce?: number\n}\n\n/**\n * Persists selected paths to a storage backend (localStorage by default).\n * Debounced to avoid excessive writes.\n */\nexport function persistenceMiddleware(options: PersistenceOptions = {}): Middleware {\n  const storageKey = options.key ?? 'skygraph:state'\n  const storage = options.storage ?? (typeof localStorage !== 'undefined' ? localStorage : null)\n  const paths = options.paths\n  const debounceMs = options.debounce ?? 100\n\n  let pending: Record<string, unknown> = {}\n  let timer: ReturnType<typeof setTimeout> | null = null\n\n  function flush() {\n    if (!storage) return\n    const existing = storage.getItem(storageKey)\n    let data: Record<string, unknown> = {}\n    if (existing) {\n      try {\n        data = JSON.parse(existing)\n      } catch {\n        /* corrupted, start fresh */\n      }\n    }\n    Object.assign(data, pending)\n    storage.setItem(storageKey, JSON.stringify(data))\n    pending = {}\n    timer = null\n  }\n\n  return (event: WriteEvent, next: NextFn) => {\n    next(event)\n\n    if (paths && !paths.some((p) => event.path === p || event.path.startsWith(p + '.'))) {\n      return\n    }\n\n    pending[event.path] = event.value\n\n    if (timer === null) {\n      timer = setTimeout(flush, debounceMs)\n    }\n  }\n}\n","import type { Middleware, WriteEvent, NextFn } from '../types'\n\nexport type Validator = (event: WriteEvent) => boolean | string\n\nexport interface ValidationMiddlewareOptions {\n  validators: Record<string, Validator>\n  onReject?: (event: WriteEvent, reason: string) => void\n}\n\n/**\n * Validates writes against a map of path -> validator.\n * If the validator returns false or a string (error message),\n * the write is rejected and onReject is called (if provided).\n */\nexport function validationMiddleware(\n  optionsOrValidators: ValidationMiddlewareOptions | Record<string, Validator>,\n): Middleware {\n  const isOptions = 'validators' in optionsOrValidators\n  const validators: Record<string, Validator> = isOptions\n    ? (optionsOrValidators as ValidationMiddlewareOptions).validators\n    : (optionsOrValidators as Record<string, Validator>)\n  const onReject = isOptions\n    ? (optionsOrValidators as ValidationMiddlewareOptions).onReject\n    : undefined\n\n  return (event: WriteEvent, next: NextFn) => {\n    const validator = validators[event.path]\n    if (validator) {\n      const result = validator(event)\n      if (result === false || typeof result === 'string') {\n        onReject?.(event, typeof result === 'string' ? result : 'Validation failed')\n        return\n      }\n    }\n    next(event)\n  }\n}\n","import type { Core, Middleware, WriteEvent, NextFn } from '../types'\n\nexport interface HistoryEntry {\n  timestamp: number\n  patches: ReadonlyArray<{ path: string; value: unknown; oldValue: unknown }>\n}\n\nexport interface HistoryPlugin {\n  readonly entries: ReadonlyArray<HistoryEntry>\n  readonly cursor: number\n  readonly canUndo: boolean\n  readonly canRedo: boolean\n\n  undo(): void\n  redo(): void\n  jumpTo(index: number): void\n  clear(): void\n  destroy(): void\n}\n\nexport interface HistoryOptions {\n  maxEntries?: number\n  /** Group multiple writes within this window (ms) into a single entry */\n  groupWindow?: number\n  filter?: (event: WriteEvent) => boolean\n}\n\nexport function createHistory(core: Core, options: HistoryOptions = {}): HistoryPlugin {\n  const maxEntries = options.maxEntries ?? 100\n  const groupWindow = options.groupWindow ?? 0\n  const filter = options.filter\n\n  const entries: HistoryEntry[] = []\n  let cursor = -1\n  let travelling = false\n  let groupTimer: ReturnType<typeof setTimeout> | null = null\n  let pendingPatches: HistoryEntry['patches'][number][] = []\n\n  function flushGroup() {\n    if (pendingPatches.length === 0) return\n    const entry: HistoryEntry = {\n      timestamp: Date.now(),\n      patches: [...pendingPatches],\n    }\n    pendingPatches = []\n\n    if (cursor < entries.length - 1) {\n      entries.splice(cursor + 1)\n    }\n\n    entries.push(entry)\n    cursor++\n    if (entries.length > maxEntries) {\n      entries.shift()\n      cursor--\n    }\n\n    groupTimer = null\n  }\n\n  const middleware: Middleware = (event: WriteEvent, next: NextFn) => {\n    next(event)\n\n    if (travelling) return\n    if (event.source === 'computed') return\n    if (filter && !filter(event)) return\n\n    pendingPatches.push({\n      path: event.path,\n      value: event.value,\n      oldValue: event.oldValue,\n    })\n\n    if (groupWindow > 0) {\n      if (groupTimer === null) {\n        groupTimer = setTimeout(flushGroup, groupWindow)\n      }\n    } else {\n      flushGroup()\n    }\n  }\n\n  const unsub = core.use(middleware)\n\n  function applyPatches(patches: HistoryEntry['patches'], direction: 'undo' | 'redo') {\n    travelling = true\n    try {\n      core.batch(() => {\n        if (direction === 'undo') {\n          for (let i = patches.length - 1; i >= 0; i--) {\n            core.set(patches[i].path, patches[i].oldValue)\n          }\n        } else {\n          for (const patch of patches) {\n            core.set(patch.path, patch.value)\n          }\n        }\n      })\n    } finally {\n      travelling = false\n    }\n  }\n\n  return {\n    get entries() {\n      return entries as ReadonlyArray<HistoryEntry>\n    },\n    get cursor() {\n      return cursor\n    },\n    get canUndo() {\n      return cursor >= 0\n    },\n    get canRedo() {\n      return cursor < entries.length - 1\n    },\n\n    undo() {\n      if (cursor < 0) return\n      flushGroup()\n      applyPatches(entries[cursor].patches, 'undo')\n      cursor--\n    },\n\n    redo() {\n      if (cursor >= entries.length - 1) return\n      flushGroup()\n      cursor++\n      applyPatches(entries[cursor].patches, 'redo')\n    },\n\n    jumpTo(index: number) {\n      if (index < -1 || index >= entries.length) return\n      flushGroup()\n\n      while (cursor > index) {\n        applyPatches(entries[cursor].patches, 'undo')\n        cursor--\n      }\n      while (cursor < index) {\n        cursor++\n        applyPatches(entries[cursor].patches, 'redo')\n      }\n    },\n\n    clear() {\n      entries.length = 0\n      cursor = -1\n      pendingPatches = []\n      if (groupTimer !== null) {\n        clearTimeout(groupTimer)\n        groupTimer = null\n      }\n    },\n\n    destroy() {\n      this.clear()\n      unsub()\n    },\n  }\n}\n","import type { Core } from './types'\n\n/**\n * Utility types for path-based type inference.\n * These provide compile-time type safety over the untyped Core runtime.\n */\n\ntype Primitive = string | number | boolean | null | undefined\n\n/**\n * Extracts dot-notation paths from a nested object type (max 3 levels deep).\n * Example: Path<{user: {name: string}}> = \"user\" | \"user.name\"\n */\nexport type Path<T> = T extends Primitive\n  ? never\n  : {\n      [K in keyof T & string]: T[K] extends Primitive\n        ? K\n        : T[K] extends Record<string, unknown>\n          ?\n              | K\n              | `${K}.${keyof T[K] & string}`\n              | {\n                  [L in keyof T[K] & string]: T[K][L] extends Record<\n                    string,\n                    unknown\n                  >\n                    ? `${K}.${L}.${keyof T[K][L] & string}`\n                    : never\n                }[keyof T[K] & string]\n          : K\n    }[keyof T & string]\n\n/**\n * Resolves the value type at a given dot-notation path (max 3 levels).\n */\nexport type PathValue<T, P extends string> = P extends keyof T\n  ? T[P]\n  : P extends `${infer K}.${infer Rest}`\n    ? K extends keyof T\n      ? Rest extends keyof T[K]\n        ? T[K][Rest]\n        : Rest extends `${infer L}.${infer M}`\n          ? L extends keyof T[K]\n            ? M extends keyof T[K][L]\n              ? T[K][L][M]\n              : unknown\n            : unknown\n          : unknown\n      : unknown\n    : unknown\n\n/**\n * Type-safe wrapper over Core.\n * Compile-time only — runtime behavior is identical to Core.\n */\nexport interface TypedCore<T> {\n  get<K extends Path<T>>(path: K): PathValue<T, K>\n  set<K extends Path<T>>(path: K, value: PathValue<T, K>): void\n  subscribe<K extends Path<T>>(\n    path: K,\n    cb: (value: PathValue<T, K>) => void\n  ): () => void\n  batch(fn: () => void): void\n  transaction(fn: () => void): void\n  computed<K extends Path<T>>(\n    target: K,\n    deps: Path<T>[],\n    fn: (...values: unknown[]) => PathValue<T, K>\n  ): void\n  /** Access the untyped core underneath */\n  raw: Core\n}\n\n/**\n * Creates a type-safe wrapper around an existing Core instance.\n * No runtime overhead — just type narrowing.\n */\nexport function createTypedCore<T>(core: Core): TypedCore<T> {\n  return {\n    get: core.get.bind(core) as TypedCore<T>['get'],\n    set: core.set.bind(core) as TypedCore<T>['set'],\n    subscribe: core.subscribe.bind(core) as TypedCore<T>['subscribe'],\n    batch: core.batch.bind(core),\n    transaction: core.transaction.bind(core),\n    computed: core.computed.bind(core) as TypedCore<T>['computed'],\n    raw: core,\n  }\n}\n"],"mappings":"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","names":[]}