specnav-core 0.2.0

package/dist/performance.js

@@ -0,0 +1,37 @@
+// src/performance.ts
+var PerformanceMonitor = class {
+  metrics = [];
+  maxMetrics = 100;
+  recordNavigation(metrics) {
+    this.metrics.push(metrics);
+    if (this.metrics.length > this.maxMetrics) {
+      this.metrics.shift();
+    }
+  }
+  getAverageNavigationTime() {
+    if (this.metrics.length === 0) return 0;
+    const sum = this.metrics.reduce((acc, m) => acc + m.navigationTime, 0);
+    return sum / this.metrics.length;
+  }
+  getCacheHitRate() {
+    if (this.metrics.length === 0) return 0;
+    const hits = this.metrics.filter((m) => m.cacheHit).length;
+    return hits / this.metrics.length;
+  }
+  getSpeculativeHitRate() {
+    if (this.metrics.length === 0) return 0;
+    const hits = this.metrics.filter((m) => m.speculativeHit).length;
+    return hits / this.metrics.length;
+  }
+  getMetrics() {
+    return [...this.metrics];
+  }
+  clear() {
+    this.metrics = [];
+  }
+};
+var performanceMonitor = new PerformanceMonitor();
+
+export { PerformanceMonitor, performanceMonitor };
+//# sourceMappingURL=performance.js.map
+//# sourceMappingURL=performance.js.map

package/dist/performance.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/performance.ts"],"names":[],"mappings":";AAWO,IAAM,qBAAN,MAAyB;AAAA,EACtB,UAAgC,EAAC;AAAA,EACjC,UAAA,GAAa,GAAA;AAAA,EAErB,iBAAiB,OAAA,EAAmC;AAClD,IAAA,IAAA,CAAK,OAAA,CAAQ,KAAK,OAAO,CAAA;AAGzB,IAAA,IAAI,IAAA,CAAK,OAAA,CAAQ,MAAA,GAAS,IAAA,CAAK,UAAA,EAAY;AACzC,MAAA,IAAA,CAAK,QAAQ,KAAA,EAAM;AAAA,IACrB;AAAA,EACF;AAAA,EAEA,wBAAA,GAAmC;AACjC,IAAA,IAAI,IAAA,CAAK,OAAA,CAAQ,MAAA,KAAW,CAAA,EAAG,OAAO,CAAA;AACtC,IAAA,MAAM,GAAA,GAAM,IAAA,CAAK,OAAA,CAAQ,MAAA,CAAO,CAAC,KAAK,CAAA,KAAM,GAAA,GAAM,CAAA,CAAE,cAAA,EAAgB,CAAC,CAAA;AACrE,IAAA,OAAO,GAAA,GAAM,KAAK,OAAA,CAAQ,MAAA;AAAA,EAC5B;AAAA,EAEA,eAAA,GAA0B;AACxB,IAAA,IAAI,IAAA,CAAK,OAAA,CAAQ,MAAA,KAAW,CAAA,EAAG,OAAO,CAAA;AACtC,IAAA,MAAM,OAAO,IAAA,CAAK,OAAA,CAAQ,OAAO,CAAA,CAAA,KAAK,CAAA,CAAE,QAAQ,CAAA,CAAE,MAAA;AAClD,IAAA,OAAO,IAAA,GAAO,KAAK,OAAA,CAAQ,MAAA;AAAA,EAC7B;AAAA,EAEA,qBAAA,GAAgC;AAC9B,IAAA,IAAI,IAAA,CAAK,OAAA,CAAQ,MAAA,KAAW,CAAA,EAAG,OAAO,CAAA;AACtC,IAAA,MAAM,OAAO,IAAA,CAAK,OAAA,CAAQ,OAAO,CAAA,CAAA,KAAK,CAAA,CAAE,cAAc,CAAA,CAAE,MAAA;AACxD,IAAA,OAAO,IAAA,GAAO,KAAK,OAAA,CAAQ,MAAA;AAAA,EAC7B;AAAA,EAEA,UAAA,GAAmC;AACjC,IAAA,OAAO,CAAC,GAAG,IAAA,CAAK,OAAO,CAAA;AAAA,EACzB;AAAA,EAEA,KAAA,GAAc;AACZ,IAAA,IAAA,CAAK,UAAU,EAAC;AAAA,EAClB;AACF;AAEO,IAAM,kBAAA,GAAqB,IAAI,kBAAA","file":"performance.js","sourcesContent":["// Performance monitoring utilities\n\nexport interface PerformanceMetrics {\n  navigationTime: number;\n  cacheHit: boolean;\n  cacheLayer?: 1 | 2 | 3;\n  speculativeHit: boolean;\n  fetchTime?: number;\n  morphTime?: number;\n}\n\nexport class PerformanceMonitor {\n  private metrics: PerformanceMetrics[] = [];\n  private maxMetrics = 100;\n\n  recordNavigation(metrics: PerformanceMetrics): void {\n    this.metrics.push(metrics);\n    \n    // Keep only last N metrics\n    if (this.metrics.length > this.maxMetrics) {\n      this.metrics.shift();\n    }\n  }\n\n  getAverageNavigationTime(): number {\n    if (this.metrics.length === 0) return 0;\n    const sum = this.metrics.reduce((acc, m) => acc + m.navigationTime, 0);\n    return sum / this.metrics.length;\n  }\n\n  getCacheHitRate(): number {\n    if (this.metrics.length === 0) return 0;\n    const hits = this.metrics.filter(m => m.cacheHit).length;\n    return hits / this.metrics.length;\n  }\n\n  getSpeculativeHitRate(): number {\n    if (this.metrics.length === 0) return 0;\n    const hits = this.metrics.filter(m => m.speculativeHit).length;\n    return hits / this.metrics.length;\n  }\n\n  getMetrics(): PerformanceMetrics[] {\n    return [...this.metrics];\n  }\n\n  clear(): void {\n    this.metrics = [];\n  }\n}\n\nexport const performanceMonitor = new PerformanceMonitor();\n"]}

package/dist/speculator.cjs

@@ -0,0 +1,59 @@
+'use strict';
+
+// src/speculator.ts
+var SpeculativeRenderer = class {
+  speculations = /* @__PURE__ */ new Map();
+  maxSpeculations;
+  constructor(maxSpeculations = 3) {
+    this.maxSpeculations = maxSpeculations;
+  }
+  async speculate(href, html) {
+    if (this.speculations.has(href)) return;
+    if (this.speculations.size >= this.maxSpeculations) {
+      const oldest = Array.from(this.speculations.values()).sort(
+        (a, b) => a.timestamp - b.timestamp
+      )[0];
+      if (oldest) this.cancel(oldest.href);
+    }
+    const container = this.createDetachedContainer();
+    container.innerHTML = html;
+    this.speculations.set(href, {
+      href,
+      html,
+      container,
+      timestamp: Date.now()
+    });
+  }
+  get(href) {
+    const speculation = this.speculations.get(href);
+    return speculation?.container ?? null;
+  }
+  cancel(href) {
+    const speculation = this.speculations.get(href);
+    if (speculation) {
+      speculation.container.remove();
+      this.speculations.delete(href);
+    }
+  }
+  cancelAll() {
+    this.speculations.forEach((spec) => spec.container.remove());
+    this.speculations.clear();
+  }
+  has(href) {
+    return this.speculations.has(href);
+  }
+  createDetachedContainer() {
+    const container = document.createElement("div");
+    container.style.display = "none";
+    container.setAttribute("data-specnav-speculation", "true");
+    return container;
+  }
+};
+function createSpeculativeRenderer(maxSpeculations) {
+  return new SpeculativeRenderer(maxSpeculations);
+}
+
+exports.SpeculativeRenderer = SpeculativeRenderer;
+exports.createSpeculativeRenderer = createSpeculativeRenderer;
+//# sourceMappingURL=speculator.cjs.map
+//# sourceMappingURL=speculator.cjs.map

package/dist/speculator.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/speculator.ts"],"names":[],"mappings":";;;AAkBO,IAAM,sBAAN,MAA0B;AAAA,EACvB,YAAA,uBAAgD,GAAA,EAAI;AAAA,EACpD,eAAA;AAAA,EAER,WAAA,CAAY,kBAAkB,CAAA,EAAG;AAC/B,IAAA,IAAA,CAAK,eAAA,GAAkB,eAAA;AAAA,EACzB;AAAA,EAEA,MAAM,SAAA,CAAU,IAAA,EAAc,IAAA,EAA6B;AACzD,IAAA,IAAI,IAAA,CAAK,YAAA,CAAa,GAAA,CAAI,IAAI,CAAA,EAAG;AAGjC,IAAA,IAAI,IAAA,CAAK,YAAA,CAAa,IAAA,IAAQ,IAAA,CAAK,eAAA,EAAiB;AAClD,MAAA,MAAM,SAAS,KAAA,CAAM,IAAA,CAAK,KAAK,YAAA,CAAa,MAAA,EAAQ,CAAA,CAAE,IAAA;AAAA,QACpD,CAAC,CAAA,EAAG,CAAA,KAAM,CAAA,CAAE,YAAY,CAAA,CAAE;AAAA,QAC1B,CAAC,CAAA;AACH,MAAA,IAAI,MAAA,EAAQ,IAAA,CAAK,MAAA,CAAO,MAAA,CAAO,IAAI,CAAA;AAAA,IACrC;AAEA,IAAA,MAAM,SAAA,GAAY,KAAK,uBAAA,EAAwB;AAC/C,IAAA,SAAA,CAAU,SAAA,GAAY,IAAA;AAEtB,IAAA,IAAA,CAAK,YAAA,CAAa,IAAI,IAAA,EAAM;AAAA,MAC1B,IAAA;AAAA,MACA,IAAA;AAAA,MACA,SAAA;AAAA,MACA,SAAA,EAAW,KAAK,GAAA;AAAI,KACrB,CAAA;AAAA,EACH;AAAA,EAEA,IAAI,IAAA,EAAkC;AACpC,IAAA,MAAM,WAAA,GAAc,IAAA,CAAK,YAAA,CAAa,GAAA,CAAI,IAAI,CAAA;AAC9C,IAAA,OAAO,aAAa,SAAA,IAAa,IAAA;AAAA,EACnC;AAAA,EAEA,OAAO,IAAA,EAAoB;AACzB,IAAA,MAAM,WAAA,GAAc,IAAA,CAAK,YAAA,CAAa,GAAA,CAAI,IAAI,CAAA;AAC9C,IAAA,IAAI,WAAA,EAAa;AACf,MAAA,WAAA,CAAY,UAAU,MAAA,EAAO;AAC7B,MAAA,IAAA,CAAK,YAAA,CAAa,OAAO,IAAI,CAAA;AAAA,IAC/B;AAAA,EACF;AAAA,EAEA,SAAA,GAAkB;AAChB,IAAA,IAAA,CAAK,aAAa,OAAA,CAAQ,CAAC,SAAS,IAAA,CAAK,SAAA,CAAU,QAAQ,CAAA;AAC3D,IAAA,IAAA,CAAK,aAAa,KAAA,EAAM;AAAA,EAC1B;AAAA,EAEA,IAAI,IAAA,EAAuB;AACzB,IAAA,OAAO,IAAA,CAAK,YAAA,CAAa,GAAA,CAAI,IAAI,CAAA;AAAA,EACnC;AAAA,EAEQ,uBAAA,GAAuC;AAC7C,IAAA,MAAM,SAAA,GAAY,QAAA,CAAS,aAAA,CAAc,KAAK,CAAA;AAC9C,IAAA,SAAA,CAAU,MAAM,OAAA,GAAU,MAAA;AAC1B,IAAA,SAAA,CAAU,YAAA,CAAa,4BAA4B,MAAM,CAAA;AACzD,IAAA,OAAO,SAAA;AAAA,EACT;AACF;AAEO,SAAS,0BACd,eAAA,EACqB;AACrB,EAAA,OAAO,IAAI,oBAAoB,eAAe,CAAA;AAChD","file":"speculator.cjs","sourcesContent":["interface SpeculatedPage {\n  href: string;\n  html: string;\n  container: HTMLElement;\n  timestamp: number;\n}\n\n/**\n * SpeculativeRenderer pre-renders pages in detached DOM containers.\n * \n * LIMITATIONS:\n * - This implementation uses innerHTML, NOT React rendering. The speculated content\n *   is raw HTML set on a disconnected DOM node, not a fully rendered React component tree.\n * - For true React speculative rendering, the container must be appended to the document\n *   (hidden via CSS) and ReactDOM.createRoot(container).render(...) must be called.\n * - Current implementation is suitable for static HTML morphing but may produce different\n *   results than a real React render for dynamic components.\n */\nexport class SpeculativeRenderer {\n  private speculations: Map<string, SpeculatedPage> = new Map();\n  private maxSpeculations: number;\n\n  constructor(maxSpeculations = 3) {\n    this.maxSpeculations = maxSpeculations;\n  }\n\n  async speculate(href: string, html: string): Promise<void> {\n    if (this.speculations.has(href)) return;\n\n    // Evict oldest if at capacity\n    if (this.speculations.size >= this.maxSpeculations) {\n      const oldest = Array.from(this.speculations.values()).sort(\n        (a, b) => a.timestamp - b.timestamp\n      )[0];\n      if (oldest) this.cancel(oldest.href);\n    }\n\n    const container = this.createDetachedContainer();\n    container.innerHTML = html;\n\n    this.speculations.set(href, {\n      href,\n      html,\n      container,\n      timestamp: Date.now(),\n    });\n  }\n\n  get(href: string): HTMLElement | null {\n    const speculation = this.speculations.get(href);\n    return speculation?.container ?? null;\n  }\n\n  cancel(href: string): void {\n    const speculation = this.speculations.get(href);\n    if (speculation) {\n      speculation.container.remove();\n      this.speculations.delete(href);\n    }\n  }\n\n  cancelAll(): void {\n    this.speculations.forEach((spec) => spec.container.remove());\n    this.speculations.clear();\n  }\n\n  has(href: string): boolean {\n    return this.speculations.has(href);\n  }\n\n  private createDetachedContainer(): HTMLElement {\n    const container = document.createElement(\"div\");\n    container.style.display = \"none\";\n    container.setAttribute(\"data-specnav-speculation\", \"true\");\n    return container;\n  }\n}\n\nexport function createSpeculativeRenderer(\n  maxSpeculations?: number\n): SpeculativeRenderer {\n  return new SpeculativeRenderer(maxSpeculations);\n}\n"]}

package/dist/speculator.d.cts

@@ -0,0 +1,14 @@
+declare class SpeculativeRenderer {
+    private speculations;
+    private maxSpeculations;
+    constructor(maxSpeculations?: number);
+    speculate(href: string, html: string): Promise<void>;
+    get(href: string): HTMLElement | null;
+    cancel(href: string): void;
+    cancelAll(): void;
+    has(href: string): boolean;
+    private createDetachedContainer;
+}
+declare function createSpeculativeRenderer(maxSpeculations?: number): SpeculativeRenderer;
+
+export { SpeculativeRenderer, createSpeculativeRenderer };

package/dist/speculator.d.ts

@@ -0,0 +1,14 @@
+declare class SpeculativeRenderer {
+    private speculations;
+    private maxSpeculations;
+    constructor(maxSpeculations?: number);
+    speculate(href: string, html: string): Promise<void>;
+    get(href: string): HTMLElement | null;
+    cancel(href: string): void;
+    cancelAll(): void;
+    has(href: string): boolean;
+    private createDetachedContainer;
+}
+declare function createSpeculativeRenderer(maxSpeculations?: number): SpeculativeRenderer;
+
+export { SpeculativeRenderer, createSpeculativeRenderer };

package/dist/speculator.js

@@ -0,0 +1,56 @@
+// src/speculator.ts
+var SpeculativeRenderer = class {
+  speculations = /* @__PURE__ */ new Map();
+  maxSpeculations;
+  constructor(maxSpeculations = 3) {
+    this.maxSpeculations = maxSpeculations;
+  }
+  async speculate(href, html) {
+    if (this.speculations.has(href)) return;
+    if (this.speculations.size >= this.maxSpeculations) {
+      const oldest = Array.from(this.speculations.values()).sort(
+        (a, b) => a.timestamp - b.timestamp
+      )[0];
+      if (oldest) this.cancel(oldest.href);
+    }
+    const container = this.createDetachedContainer();
+    container.innerHTML = html;
+    this.speculations.set(href, {
+      href,
+      html,
+      container,
+      timestamp: Date.now()
+    });
+  }
+  get(href) {
+    const speculation = this.speculations.get(href);
+    return speculation?.container ?? null;
+  }
+  cancel(href) {
+    const speculation = this.speculations.get(href);
+    if (speculation) {
+      speculation.container.remove();
+      this.speculations.delete(href);
+    }
+  }
+  cancelAll() {
+    this.speculations.forEach((spec) => spec.container.remove());
+    this.speculations.clear();
+  }
+  has(href) {
+    return this.speculations.has(href);
+  }
+  createDetachedContainer() {
+    const container = document.createElement("div");
+    container.style.display = "none";
+    container.setAttribute("data-specnav-speculation", "true");
+    return container;
+  }
+};
+function createSpeculativeRenderer(maxSpeculations) {
+  return new SpeculativeRenderer(maxSpeculations);
+}
+
+export { SpeculativeRenderer, createSpeculativeRenderer };
+//# sourceMappingURL=speculator.js.map
+//# sourceMappingURL=speculator.js.map

package/dist/speculator.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/speculator.ts"],"names":[],"mappings":";AAkBO,IAAM,sBAAN,MAA0B;AAAA,EACvB,YAAA,uBAAgD,GAAA,EAAI;AAAA,EACpD,eAAA;AAAA,EAER,WAAA,CAAY,kBAAkB,CAAA,EAAG;AAC/B,IAAA,IAAA,CAAK,eAAA,GAAkB,eAAA;AAAA,EACzB;AAAA,EAEA,MAAM,SAAA,CAAU,IAAA,EAAc,IAAA,EAA6B;AACzD,IAAA,IAAI,IAAA,CAAK,YAAA,CAAa,GAAA,CAAI,IAAI,CAAA,EAAG;AAGjC,IAAA,IAAI,IAAA,CAAK,YAAA,CAAa,IAAA,IAAQ,IAAA,CAAK,eAAA,EAAiB;AAClD,MAAA,MAAM,SAAS,KAAA,CAAM,IAAA,CAAK,KAAK,YAAA,CAAa,MAAA,EAAQ,CAAA,CAAE,IAAA;AAAA,QACpD,CAAC,CAAA,EAAG,CAAA,KAAM,CAAA,CAAE,YAAY,CAAA,CAAE;AAAA,QAC1B,CAAC,CAAA;AACH,MAAA,IAAI,MAAA,EAAQ,IAAA,CAAK,MAAA,CAAO,MAAA,CAAO,IAAI,CAAA;AAAA,IACrC;AAEA,IAAA,MAAM,SAAA,GAAY,KAAK,uBAAA,EAAwB;AAC/C,IAAA,SAAA,CAAU,SAAA,GAAY,IAAA;AAEtB,IAAA,IAAA,CAAK,YAAA,CAAa,IAAI,IAAA,EAAM;AAAA,MAC1B,IAAA;AAAA,MACA,IAAA;AAAA,MACA,SAAA;AAAA,MACA,SAAA,EAAW,KAAK,GAAA;AAAI,KACrB,CAAA;AAAA,EACH;AAAA,EAEA,IAAI,IAAA,EAAkC;AACpC,IAAA,MAAM,WAAA,GAAc,IAAA,CAAK,YAAA,CAAa,GAAA,CAAI,IAAI,CAAA;AAC9C,IAAA,OAAO,aAAa,SAAA,IAAa,IAAA;AAAA,EACnC;AAAA,EAEA,OAAO,IAAA,EAAoB;AACzB,IAAA,MAAM,WAAA,GAAc,IAAA,CAAK,YAAA,CAAa,GAAA,CAAI,IAAI,CAAA;AAC9C,IAAA,IAAI,WAAA,EAAa;AACf,MAAA,WAAA,CAAY,UAAU,MAAA,EAAO;AAC7B,MAAA,IAAA,CAAK,YAAA,CAAa,OAAO,IAAI,CAAA;AAAA,IAC/B;AAAA,EACF;AAAA,EAEA,SAAA,GAAkB;AAChB,IAAA,IAAA,CAAK,aAAa,OAAA,CAAQ,CAAC,SAAS,IAAA,CAAK,SAAA,CAAU,QAAQ,CAAA;AAC3D,IAAA,IAAA,CAAK,aAAa,KAAA,EAAM;AAAA,EAC1B;AAAA,EAEA,IAAI,IAAA,EAAuB;AACzB,IAAA,OAAO,IAAA,CAAK,YAAA,CAAa,GAAA,CAAI,IAAI,CAAA;AAAA,EACnC;AAAA,EAEQ,uBAAA,GAAuC;AAC7C,IAAA,MAAM,SAAA,GAAY,QAAA,CAAS,aAAA,CAAc,KAAK,CAAA;AAC9C,IAAA,SAAA,CAAU,MAAM,OAAA,GAAU,MAAA;AAC1B,IAAA,SAAA,CAAU,YAAA,CAAa,4BAA4B,MAAM,CAAA;AACzD,IAAA,OAAO,SAAA;AAAA,EACT;AACF;AAEO,SAAS,0BACd,eAAA,EACqB;AACrB,EAAA,OAAO,IAAI,oBAAoB,eAAe,CAAA;AAChD","file":"speculator.js","sourcesContent":["interface SpeculatedPage {\n  href: string;\n  html: string;\n  container: HTMLElement;\n  timestamp: number;\n}\n\n/**\n * SpeculativeRenderer pre-renders pages in detached DOM containers.\n * \n * LIMITATIONS:\n * - This implementation uses innerHTML, NOT React rendering. The speculated content\n *   is raw HTML set on a disconnected DOM node, not a fully rendered React component tree.\n * - For true React speculative rendering, the container must be appended to the document\n *   (hidden via CSS) and ReactDOM.createRoot(container).render(...) must be called.\n * - Current implementation is suitable for static HTML morphing but may produce different\n *   results than a real React render for dynamic components.\n */\nexport class SpeculativeRenderer {\n  private speculations: Map<string, SpeculatedPage> = new Map();\n  private maxSpeculations: number;\n\n  constructor(maxSpeculations = 3) {\n    this.maxSpeculations = maxSpeculations;\n  }\n\n  async speculate(href: string, html: string): Promise<void> {\n    if (this.speculations.has(href)) return;\n\n    // Evict oldest if at capacity\n    if (this.speculations.size >= this.maxSpeculations) {\n      const oldest = Array.from(this.speculations.values()).sort(\n        (a, b) => a.timestamp - b.timestamp\n      )[0];\n      if (oldest) this.cancel(oldest.href);\n    }\n\n    const container = this.createDetachedContainer();\n    container.innerHTML = html;\n\n    this.speculations.set(href, {\n      href,\n      html,\n      container,\n      timestamp: Date.now(),\n    });\n  }\n\n  get(href: string): HTMLElement | null {\n    const speculation = this.speculations.get(href);\n    return speculation?.container ?? null;\n  }\n\n  cancel(href: string): void {\n    const speculation = this.speculations.get(href);\n    if (speculation) {\n      speculation.container.remove();\n      this.speculations.delete(href);\n    }\n  }\n\n  cancelAll(): void {\n    this.speculations.forEach((spec) => spec.container.remove());\n    this.speculations.clear();\n  }\n\n  has(href: string): boolean {\n    return this.speculations.has(href);\n  }\n\n  private createDetachedContainer(): HTMLElement {\n    const container = document.createElement(\"div\");\n    container.style.display = \"none\";\n    container.setAttribute(\"data-specnav-speculation\", \"true\");\n    return container;\n  }\n}\n\nexport function createSpeculativeRenderer(\n  maxSpeculations?: number\n): SpeculativeRenderer {\n  return new SpeculativeRenderer(maxSpeculations);\n}\n"]}

package/dist/trajectory.cjs

@@ -0,0 +1,146 @@
+'use strict';
+
+// src/trajectory.ts
+var DEFAULT_CONFIG = {
+  lookaheadMs: 120,
+  minVelocity: 0.2,
+  sampleRate: 50,
+  cancelOnDeviation: true
+};
+var TrajectoryEngine = class {
+  samples = [];
+  links = /* @__PURE__ */ new Map();
+  config;
+  lastPrediction = null;
+  sampleInterval = null;
+  onPrediction;
+  onCancel;
+  cooldownMap = /* @__PURE__ */ new Map();
+  updateDebounceTimer = null;
+  constructor(config = {}, callbacks) {
+    this.config = { ...DEFAULT_CONFIG, ...config };
+    this.onPrediction = callbacks?.onPrediction;
+    this.onCancel = callbacks?.onCancel;
+  }
+  start() {
+    if (typeof window === "undefined") return;
+    window.addEventListener("pointermove", this.handlePointerMove);
+    this.sampleInterval = window.setInterval(
+      () => this.processSamples(),
+      this.config.sampleRate
+    );
+  }
+  stop() {
+    if (typeof window === "undefined") return;
+    window.removeEventListener("pointermove", this.handlePointerMove);
+    if (this.sampleInterval) {
+      clearInterval(this.sampleInterval);
+      this.sampleInterval = null;
+    }
+    if (this.updateDebounceTimer) {
+      clearTimeout(this.updateDebounceTimer);
+      this.updateDebounceTimer = null;
+    }
+    this.samples = [];
+    this.links.clear();
+    this.cooldownMap.clear();
+    this.lastPrediction = null;
+  }
+  registerLink(href, element) {
+    const rect = element.getBoundingClientRect();
+    this.links.set(element, { href, rect, element });
+  }
+  unregisterLink(element) {
+    this.links.delete(element);
+  }
+  updateLinkPositions() {
+    if (this.updateDebounceTimer) {
+      clearTimeout(this.updateDebounceTimer);
+    }
+    this.updateDebounceTimer = window.setTimeout(() => {
+      this.links.forEach((link, element) => {
+        const rect = element.getBoundingClientRect();
+        this.links.set(element, { ...link, rect });
+      });
+      this.updateDebounceTimer = null;
+    }, 100);
+  }
+  handlePointerMove = (e) => {
+    this.samples.push({
+      x: e.clientX,
+      y: e.clientY,
+      t: e.timeStamp
+    });
+    if (this.samples.length > 10) {
+      this.samples.shift();
+    }
+  };
+  processSamples() {
+    if (this.samples.length < 4) return;
+    const velocity = this.computeVelocity();
+    const speed = Math.sqrt(velocity.vx ** 2 + velocity.vy ** 2);
+    if (speed < this.config.minVelocity) {
+      if (this.lastPrediction && this.config.cancelOnDeviation) {
+        this.onCancel?.(this.lastPrediction);
+        this.lastPrediction = null;
+      }
+      return;
+    }
+    const target = this.predictTarget(velocity);
+    if (target && target.href !== this.lastPrediction) {
+      const now = Date.now();
+      const lastTime = this.cooldownMap.get(target.href) ?? 0;
+      const cooldown = 500;
+      if (now - lastTime < cooldown) {
+        return;
+      }
+      if (this.lastPrediction && this.config.cancelOnDeviation) {
+        this.onCancel?.(this.lastPrediction);
+      }
+      this.lastPrediction = target.href;
+      this.cooldownMap.set(target.href, now);
+      this.onPrediction?.(target.href);
+    } else if (!target && this.lastPrediction && this.config.cancelOnDeviation) {
+      this.onCancel?.(this.lastPrediction);
+      this.lastPrediction = null;
+    }
+  }
+  computeVelocity() {
+    const recent = this.samples.slice(-4);
+    const dt = recent[recent.length - 1].t - recent[0].t;
+    if (dt === 0) return { vx: 0, vy: 0 };
+    const dx = recent[recent.length - 1].x - recent[0].x;
+    const dy = recent[recent.length - 1].y - recent[0].y;
+    return {
+      vx: dx / dt,
+      vy: dy / dt
+    };
+  }
+  projectRay(velocity) {
+    const origin = this.samples[this.samples.length - 1];
+    return {
+      x: origin.x + velocity.vx * this.config.lookaheadMs,
+      y: origin.y + velocity.vy * this.config.lookaheadMs
+    };
+  }
+  predictTarget(velocity) {
+    const tip = this.projectRay(velocity);
+    for (const link of this.links.values()) {
+      if (this.rectContains(link.rect, tip)) {
+        return link;
+      }
+    }
+    return null;
+  }
+  rectContains(rect, point) {
+    return point.x >= rect.left && point.x <= rect.right && point.y >= rect.top && point.y <= rect.bottom;
+  }
+};
+function createTrajectoryEngine(config, callbacks) {
+  return new TrajectoryEngine(config, callbacks);
+}
+
+exports.TrajectoryEngine = TrajectoryEngine;
+exports.createTrajectoryEngine = createTrajectoryEngine;
+//# sourceMappingURL=trajectory.cjs.map
+//# sourceMappingURL=trajectory.cjs.map

package/dist/trajectory.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/trajectory.ts"],"names":[],"mappings":"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","file":"trajectory.cjs","sourcesContent":["import type {\n  PointerSample,\n  Velocity,\n  LinkRect,\n  TrajectoryConfig,\n} from \"./types\";\n\nconst DEFAULT_CONFIG: TrajectoryConfig = {\n  lookaheadMs: 120,\n  minVelocity: 0.2,\n  sampleRate: 50,\n  cancelOnDeviation: true,\n};\n\nexport class TrajectoryEngine {\n  private samples: PointerSample[] = [];\n  private links: Map<HTMLAnchorElement, LinkRect> = new Map();\n  private config: TrajectoryConfig;\n  private lastPrediction: string | null = null;\n  private sampleInterval: number | null = null;\n  private onPrediction?: (href: string) => void;\n  private onCancel?: (href: string) => void;\n  private cooldownMap = new Map<string, number>();\n  private updateDebounceTimer: number | null = null;\n\n  constructor(\n    config: Partial<TrajectoryConfig> = {},\n    callbacks?: {\n      onPrediction?: (href: string) => void;\n      onCancel?: (href: string) => void;\n    }\n  ) {\n    this.config = { ...DEFAULT_CONFIG, ...config };\n    this.onPrediction = callbacks?.onPrediction;\n    this.onCancel = callbacks?.onCancel;\n  }\n\n  start(): void {\n    if (typeof window === \"undefined\") return;\n\n    window.addEventListener(\"pointermove\", this.handlePointerMove);\n    this.sampleInterval = window.setInterval(\n      () => this.processSamples(),\n      this.config.sampleRate\n    );\n  }\n\n  stop(): void {\n    if (typeof window === \"undefined\") return;\n\n    window.removeEventListener(\"pointermove\", this.handlePointerMove);\n    if (this.sampleInterval) {\n      clearInterval(this.sampleInterval);\n      this.sampleInterval = null;\n    }\n    if (this.updateDebounceTimer) {\n      clearTimeout(this.updateDebounceTimer);\n      this.updateDebounceTimer = null;\n    }\n    \n    // Clean up memory\n    this.samples = [];\n    this.links.clear();\n    this.cooldownMap.clear();\n    this.lastPrediction = null;\n  }\n\n  registerLink(href: string, element: HTMLAnchorElement): void {\n    const rect = element.getBoundingClientRect();\n    this.links.set(element, { href, rect, element });\n  }\n\n  unregisterLink(element: HTMLAnchorElement): void {\n    this.links.delete(element);\n  }\n\n  updateLinkPositions(): void {\n    // Debounce to prevent excessive reflows\n    if (this.updateDebounceTimer) {\n      clearTimeout(this.updateDebounceTimer);\n    }\n\n    this.updateDebounceTimer = window.setTimeout(() => {\n      this.links.forEach((link, element) => {\n        const rect = element.getBoundingClientRect();\n        this.links.set(element, { ...link, rect });\n      });\n      this.updateDebounceTimer = null;\n    }, 100);\n  }\n\n  private handlePointerMove = (e: PointerEvent): void => {\n    this.samples.push({\n      x: e.clientX,\n      y: e.clientY,\n      t: e.timeStamp,\n    });\n\n    // Keep only last 10 samples for smoothing\n    if (this.samples.length > 10) {\n      this.samples.shift();\n    }\n  };\n\n  private processSamples(): void {\n    if (this.samples.length < 4) return;\n\n    const velocity = this.computeVelocity();\n    const speed = Math.sqrt(velocity.vx ** 2 + velocity.vy ** 2);\n\n    if (speed < this.config.minVelocity) {\n      if (this.lastPrediction && this.config.cancelOnDeviation) {\n        this.onCancel?.(this.lastPrediction);\n        this.lastPrediction = null;\n      }\n      return;\n    }\n\n    const target = this.predictTarget(velocity);\n\n    if (target && target.href !== this.lastPrediction) {\n      // Check cooldown\n      const now = Date.now();\n      const lastTime = this.cooldownMap.get(target.href) ?? 0;\n      const cooldown = 500; // 500ms cooldown per href\n      \n      if (now - lastTime < cooldown) {\n        return; // Still in cooldown\n      }\n\n      if (this.lastPrediction && this.config.cancelOnDeviation) {\n        this.onCancel?.(this.lastPrediction);\n      }\n      \n      this.lastPrediction = target.href;\n      this.cooldownMap.set(target.href, now);\n      this.onPrediction?.(target.href);\n    } else if (!target && this.lastPrediction && this.config.cancelOnDeviation) {\n      this.onCancel?.(this.lastPrediction);\n      this.lastPrediction = null;\n    }\n  }\n\n  private computeVelocity(): Velocity {\n    const recent = this.samples.slice(-4);\n    const dt = recent[recent.length - 1]!.t - recent[0]!.t;\n\n    if (dt === 0) return { vx: 0, vy: 0 };\n\n    const dx = recent[recent.length - 1]!.x - recent[0]!.x;\n    const dy = recent[recent.length - 1]!.y - recent[0]!.y;\n\n    return {\n      vx: dx / dt,\n      vy: dy / dt,\n    };\n  }\n\n  private projectRay(velocity: Velocity): { x: number; y: number } {\n    const origin = this.samples[this.samples.length - 1]!;\n    return {\n      x: origin.x + velocity.vx * this.config.lookaheadMs,\n      y: origin.y + velocity.vy * this.config.lookaheadMs,\n    };\n  }\n\n  private predictTarget(velocity: Velocity): LinkRect | null {\n    const tip = this.projectRay(velocity);\n\n    for (const link of this.links.values()) {\n      if (this.rectContains(link.rect, tip)) {\n        return link;\n      }\n    }\n\n    return null;\n  }\n\n  private rectContains(rect: DOMRect, point: { x: number; y: number }): boolean {\n    return (\n      point.x >= rect.left &&\n      point.x <= rect.right &&\n      point.y >= rect.top &&\n      point.y <= rect.bottom\n    );\n  }\n}\n\nexport function createTrajectoryEngine(\n  config?: Partial<TrajectoryConfig>,\n  callbacks?: {\n    onPrediction?: (href: string) => void;\n    onCancel?: (href: string) => void;\n  }\n): TrajectoryEngine {\n  return new TrajectoryEngine(config, callbacks);\n}\n"]}

package/dist/trajectory.d.cts

@@ -0,0 +1,34 @@
+import { T as TrajectoryConfig } from './types-DnUtmOfQ.cjs';
+
+declare class TrajectoryEngine {
+    private samples;
+    private links;
+    private config;
+    private lastPrediction;
+    private sampleInterval;
+    private onPrediction?;
+    private onCancel?;
+    private cooldownMap;
+    private updateDebounceTimer;
+    constructor(config?: Partial<TrajectoryConfig>, callbacks?: {
+        onPrediction?: (href: string) => void;
+        onCancel?: (href: string) => void;
+    });
+    start(): void;
+    stop(): void;
+    registerLink(href: string, element: HTMLAnchorElement): void;
+    unregisterLink(element: HTMLAnchorElement): void;
+    updateLinkPositions(): void;
+    private handlePointerMove;
+    private processSamples;
+    private computeVelocity;
+    private projectRay;
+    private predictTarget;
+    private rectContains;
+}
+declare function createTrajectoryEngine(config?: Partial<TrajectoryConfig>, callbacks?: {
+    onPrediction?: (href: string) => void;
+    onCancel?: (href: string) => void;
+}): TrajectoryEngine;
+
+export { TrajectoryEngine, createTrajectoryEngine };

package/dist/trajectory.d.ts

@@ -0,0 +1,34 @@
+import { T as TrajectoryConfig } from './types-DnUtmOfQ.js';
+
+declare class TrajectoryEngine {
+    private samples;
+    private links;
+    private config;
+    private lastPrediction;
+    private sampleInterval;
+    private onPrediction?;
+    private onCancel?;
+    private cooldownMap;
+    private updateDebounceTimer;
+    constructor(config?: Partial<TrajectoryConfig>, callbacks?: {
+        onPrediction?: (href: string) => void;
+        onCancel?: (href: string) => void;
+    });
+    start(): void;
+    stop(): void;
+    registerLink(href: string, element: HTMLAnchorElement): void;
+    unregisterLink(element: HTMLAnchorElement): void;
+    updateLinkPositions(): void;
+    private handlePointerMove;
+    private processSamples;
+    private computeVelocity;
+    private projectRay;
+    private predictTarget;
+    private rectContains;
+}
+declare function createTrajectoryEngine(config?: Partial<TrajectoryConfig>, callbacks?: {
+    onPrediction?: (href: string) => void;
+    onCancel?: (href: string) => void;
+}): TrajectoryEngine;
+
+export { TrajectoryEngine, createTrajectoryEngine };

package/dist/trajectory.js

@@ -0,0 +1,143 @@
+// src/trajectory.ts
+var DEFAULT_CONFIG = {
+  lookaheadMs: 120,
+  minVelocity: 0.2,
+  sampleRate: 50,
+  cancelOnDeviation: true
+};
+var TrajectoryEngine = class {
+  samples = [];
+  links = /* @__PURE__ */ new Map();
+  config;
+  lastPrediction = null;
+  sampleInterval = null;
+  onPrediction;
+  onCancel;
+  cooldownMap = /* @__PURE__ */ new Map();
+  updateDebounceTimer = null;
+  constructor(config = {}, callbacks) {
+    this.config = { ...DEFAULT_CONFIG, ...config };
+    this.onPrediction = callbacks?.onPrediction;
+    this.onCancel = callbacks?.onCancel;
+  }
+  start() {
+    if (typeof window === "undefined") return;
+    window.addEventListener("pointermove", this.handlePointerMove);
+    this.sampleInterval = window.setInterval(
+      () => this.processSamples(),
+      this.config.sampleRate
+    );
+  }
+  stop() {
+    if (typeof window === "undefined") return;
+    window.removeEventListener("pointermove", this.handlePointerMove);
+    if (this.sampleInterval) {
+      clearInterval(this.sampleInterval);
+      this.sampleInterval = null;
+    }
+    if (this.updateDebounceTimer) {
+      clearTimeout(this.updateDebounceTimer);
+      this.updateDebounceTimer = null;
+    }
+    this.samples = [];
+    this.links.clear();
+    this.cooldownMap.clear();
+    this.lastPrediction = null;
+  }
+  registerLink(href, element) {
+    const rect = element.getBoundingClientRect();
+    this.links.set(element, { href, rect, element });
+  }
+  unregisterLink(element) {
+    this.links.delete(element);
+  }
+  updateLinkPositions() {
+    if (this.updateDebounceTimer) {
+      clearTimeout(this.updateDebounceTimer);
+    }
+    this.updateDebounceTimer = window.setTimeout(() => {
+      this.links.forEach((link, element) => {
+        const rect = element.getBoundingClientRect();
+        this.links.set(element, { ...link, rect });
+      });
+      this.updateDebounceTimer = null;
+    }, 100);
+  }
+  handlePointerMove = (e) => {
+    this.samples.push({
+      x: e.clientX,
+      y: e.clientY,
+      t: e.timeStamp
+    });
+    if (this.samples.length > 10) {
+      this.samples.shift();
+    }
+  };
+  processSamples() {
+    if (this.samples.length < 4) return;
+    const velocity = this.computeVelocity();
+    const speed = Math.sqrt(velocity.vx ** 2 + velocity.vy ** 2);
+    if (speed < this.config.minVelocity) {
+      if (this.lastPrediction && this.config.cancelOnDeviation) {
+        this.onCancel?.(this.lastPrediction);
+        this.lastPrediction = null;
+      }
+      return;
+    }
+    const target = this.predictTarget(velocity);
+    if (target && target.href !== this.lastPrediction) {
+      const now = Date.now();
+      const lastTime = this.cooldownMap.get(target.href) ?? 0;
+      const cooldown = 500;
+      if (now - lastTime < cooldown) {
+        return;
+      }
+      if (this.lastPrediction && this.config.cancelOnDeviation) {
+        this.onCancel?.(this.lastPrediction);
+      }
+      this.lastPrediction = target.href;
+      this.cooldownMap.set(target.href, now);
+      this.onPrediction?.(target.href);
+    } else if (!target && this.lastPrediction && this.config.cancelOnDeviation) {
+      this.onCancel?.(this.lastPrediction);
+      this.lastPrediction = null;
+    }
+  }
+  computeVelocity() {
+    const recent = this.samples.slice(-4);
+    const dt = recent[recent.length - 1].t - recent[0].t;
+    if (dt === 0) return { vx: 0, vy: 0 };
+    const dx = recent[recent.length - 1].x - recent[0].x;
+    const dy = recent[recent.length - 1].y - recent[0].y;
+    return {
+      vx: dx / dt,
+      vy: dy / dt
+    };
+  }
+  projectRay(velocity) {
+    const origin = this.samples[this.samples.length - 1];
+    return {
+      x: origin.x + velocity.vx * this.config.lookaheadMs,
+      y: origin.y + velocity.vy * this.config.lookaheadMs
+    };
+  }
+  predictTarget(velocity) {
+    const tip = this.projectRay(velocity);
+    for (const link of this.links.values()) {
+      if (this.rectContains(link.rect, tip)) {
+        return link;
+      }
+    }
+    return null;
+  }
+  rectContains(rect, point) {
+    return point.x >= rect.left && point.x <= rect.right && point.y >= rect.top && point.y <= rect.bottom;
+  }
+};
+function createTrajectoryEngine(config, callbacks) {
+  return new TrajectoryEngine(config, callbacks);
+}
+
+export { TrajectoryEngine, createTrajectoryEngine };
+//# sourceMappingURL=trajectory.js.map
+//# sourceMappingURL=trajectory.js.map

package/dist/trajectory.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/trajectory.ts"],"names":[],"mappings":"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","file":"trajectory.js","sourcesContent":["import type {\n  PointerSample,\n  Velocity,\n  LinkRect,\n  TrajectoryConfig,\n} from \"./types\";\n\nconst DEFAULT_CONFIG: TrajectoryConfig = {\n  lookaheadMs: 120,\n  minVelocity: 0.2,\n  sampleRate: 50,\n  cancelOnDeviation: true,\n};\n\nexport class TrajectoryEngine {\n  private samples: PointerSample[] = [];\n  private links: Map<HTMLAnchorElement, LinkRect> = new Map();\n  private config: TrajectoryConfig;\n  private lastPrediction: string | null = null;\n  private sampleInterval: number | null = null;\n  private onPrediction?: (href: string) => void;\n  private onCancel?: (href: string) => void;\n  private cooldownMap = new Map<string, number>();\n  private updateDebounceTimer: number | null = null;\n\n  constructor(\n    config: Partial<TrajectoryConfig> = {},\n    callbacks?: {\n      onPrediction?: (href: string) => void;\n      onCancel?: (href: string) => void;\n    }\n  ) {\n    this.config = { ...DEFAULT_CONFIG, ...config };\n    this.onPrediction = callbacks?.onPrediction;\n    this.onCancel = callbacks?.onCancel;\n  }\n\n  start(): void {\n    if (typeof window === \"undefined\") return;\n\n    window.addEventListener(\"pointermove\", this.handlePointerMove);\n    this.sampleInterval = window.setInterval(\n      () => this.processSamples(),\n      this.config.sampleRate\n    );\n  }\n\n  stop(): void {\n    if (typeof window === \"undefined\") return;\n\n    window.removeEventListener(\"pointermove\", this.handlePointerMove);\n    if (this.sampleInterval) {\n      clearInterval(this.sampleInterval);\n      this.sampleInterval = null;\n    }\n    if (this.updateDebounceTimer) {\n      clearTimeout(this.updateDebounceTimer);\n      this.updateDebounceTimer = null;\n    }\n    \n    // Clean up memory\n    this.samples = [];\n    this.links.clear();\n    this.cooldownMap.clear();\n    this.lastPrediction = null;\n  }\n\n  registerLink(href: string, element: HTMLAnchorElement): void {\n    const rect = element.getBoundingClientRect();\n    this.links.set(element, { href, rect, element });\n  }\n\n  unregisterLink(element: HTMLAnchorElement): void {\n    this.links.delete(element);\n  }\n\n  updateLinkPositions(): void {\n    // Debounce to prevent excessive reflows\n    if (this.updateDebounceTimer) {\n      clearTimeout(this.updateDebounceTimer);\n    }\n\n    this.updateDebounceTimer = window.setTimeout(() => {\n      this.links.forEach((link, element) => {\n        const rect = element.getBoundingClientRect();\n        this.links.set(element, { ...link, rect });\n      });\n      this.updateDebounceTimer = null;\n    }, 100);\n  }\n\n  private handlePointerMove = (e: PointerEvent): void => {\n    this.samples.push({\n      x: e.clientX,\n      y: e.clientY,\n      t: e.timeStamp,\n    });\n\n    // Keep only last 10 samples for smoothing\n    if (this.samples.length > 10) {\n      this.samples.shift();\n    }\n  };\n\n  private processSamples(): void {\n    if (this.samples.length < 4) return;\n\n    const velocity = this.computeVelocity();\n    const speed = Math.sqrt(velocity.vx ** 2 + velocity.vy ** 2);\n\n    if (speed < this.config.minVelocity) {\n      if (this.lastPrediction && this.config.cancelOnDeviation) {\n        this.onCancel?.(this.lastPrediction);\n        this.lastPrediction = null;\n      }\n      return;\n    }\n\n    const target = this.predictTarget(velocity);\n\n    if (target && target.href !== this.lastPrediction) {\n      // Check cooldown\n      const now = Date.now();\n      const lastTime = this.cooldownMap.get(target.href) ?? 0;\n      const cooldown = 500; // 500ms cooldown per href\n      \n      if (now - lastTime < cooldown) {\n        return; // Still in cooldown\n      }\n\n      if (this.lastPrediction && this.config.cancelOnDeviation) {\n        this.onCancel?.(this.lastPrediction);\n      }\n      \n      this.lastPrediction = target.href;\n      this.cooldownMap.set(target.href, now);\n      this.onPrediction?.(target.href);\n    } else if (!target && this.lastPrediction && this.config.cancelOnDeviation) {\n      this.onCancel?.(this.lastPrediction);\n      this.lastPrediction = null;\n    }\n  }\n\n  private computeVelocity(): Velocity {\n    const recent = this.samples.slice(-4);\n    const dt = recent[recent.length - 1]!.t - recent[0]!.t;\n\n    if (dt === 0) return { vx: 0, vy: 0 };\n\n    const dx = recent[recent.length - 1]!.x - recent[0]!.x;\n    const dy = recent[recent.length - 1]!.y - recent[0]!.y;\n\n    return {\n      vx: dx / dt,\n      vy: dy / dt,\n    };\n  }\n\n  private projectRay(velocity: Velocity): { x: number; y: number } {\n    const origin = this.samples[this.samples.length - 1]!;\n    return {\n      x: origin.x + velocity.vx * this.config.lookaheadMs,\n      y: origin.y + velocity.vy * this.config.lookaheadMs,\n    };\n  }\n\n  private predictTarget(velocity: Velocity): LinkRect | null {\n    const tip = this.projectRay(velocity);\n\n    for (const link of this.links.values()) {\n      if (this.rectContains(link.rect, tip)) {\n        return link;\n      }\n    }\n\n    return null;\n  }\n\n  private rectContains(rect: DOMRect, point: { x: number; y: number }): boolean {\n    return (\n      point.x >= rect.left &&\n      point.x <= rect.right &&\n      point.y >= rect.top &&\n      point.y <= rect.bottom\n    );\n  }\n}\n\nexport function createTrajectoryEngine(\n  config?: Partial<TrajectoryConfig>,\n  callbacks?: {\n    onPrediction?: (href: string) => void;\n    onCancel?: (href: string) => void;\n  }\n): TrajectoryEngine {\n  return new TrajectoryEngine(config, callbacks);\n}\n"]}