@factorialco/f0-react 2.56.0 → 2.57.0

package/dist/{F0CanvasPanel-BBAGq4mG.js → F0CanvasPanel-Dr6ruMgi.js}

@@ -126163,21 +126163,9 @@ const q33 = z1(
   p3("F0Dialog", V12)
 );
 function fU1(e, t) {
-  if (!e || typeof e != "object")
-    return;
-  const n = t.split(".");
-  let r = e;
-  for (const o of n)
-    if (r && typeof r == "object" && o in r)
-      r = r[o];
-    else
-      return;
-  return r;
-}
-function CU1(e, t) {
   var n = typeof Symbol < "u" && e[Symbol.iterator] || e["@@iterator"];
   if (n) return (n = n.call(e)).next.bind(n);
-  if (Array.isArray(e) || (n = hU1(e)) || t) {
+  if (Array.isArray(e) || (n = CU1(e)) || t) {
     n && (e = n);
     var r = 0;
     return function() {
@@ -126187,7 +126175,7 @@ function CU1(e, t) {
   throw new TypeError(`Invalid attempt to iterate non-iterable instance.
 In order to be iterable, non-array objects must have a [Symbol.iterator]() method.`);
 }
-function hU1(e, t) {
+function CU1(e, t) {
   if (e) {
     if (typeof e == "string") return sj(e, t);
     var n = Object.prototype.toString.call(e).slice(8, -1);
@@ -126218,7 +126206,7 @@ var SE = function() {
   return AE(e) ? Symbol[e] : "@@" + e;
 };
 SE() && !AE("observable") && (Symbol.observable = /* @__PURE__ */ Symbol("observable"));
-var mU1 = TE("iterator"), IL = TE("observable"), F12 = TE("species");
+var hU1 = TE("iterator"), IL = TE("observable"), F12 = TE("species");
 function nu(e, t) {
   var n = e[t];
   if (n != null) {
@@ -126230,7 +126218,7 @@ function qr(e) {
   var t = e.constructor;
   return t !== void 0 && (t = t[F12], t === null && (t = void 0)), t !== void 0 ? t : Od;
 }
-function pU1(e) {
+function mU1(e) {
   return e instanceof Od;
 }
 function C0(e) {
@@ -126264,7 +126252,7 @@ function S12(e) {
 function WL(e) {
   e._observer = void 0, e._queue = void 0, e._state = "closed";
 }
-function gU1(e) {
+function pU1(e) {
   var t = e._queue;
   if (t) {
     e._queue = void 0, e._state = "ready";
@@ -126308,17 +126296,17 @@ function Iv(e, t, n) {
         type: t,
         value: n
       }], Ml(function() {
-        return gU1(e);
+        return pU1(e);
       });
       return;
     }
     A12(e, t, n);
   }
 }
-var vU1 = /* @__PURE__ */ (function() {
+var gU1 = /* @__PURE__ */ (function() {
   function e(n, r) {
     this._cleanup = void 0, this._observer = n, this._queue = void 0, this._state = "initializing";
-    var o = new yU1(this);
+    var o = new vU1(this);
     try {
       this._cleanup = r.call(void 0, o);
     } catch (i) {
@@ -126335,7 +126323,7 @@ var vU1 = /* @__PURE__ */ (function() {
       return this._state === "closed";
     }
   }]), e;
-})(), yU1 = /* @__PURE__ */ (function() {
+})(), vU1 = /* @__PURE__ */ (function() {
   function e(n) {
     this._subscription = n;
   }
@@ -126364,7 +126352,7 @@ var vU1 = /* @__PURE__ */ (function() {
       next: r,
       error: arguments[1],
       complete: arguments[2]
-    }), new vU1(r, this._subscriber);
+    }), new gU1(r, this._subscriber);
   }, t.forEach = function(r) {
     var o = this;
     return new Promise(function(i, s) {
@@ -126532,15 +126520,15 @@ var vU1 = /* @__PURE__ */ (function() {
     if (i) {
       var s = i.call(r);
       if (Object(s) !== s) throw new TypeError(s + " is not an object");
-      return pU1(s) && s.constructor === o ? s : new o(function(l) {
+      return mU1(s) && s.constructor === o ? s : new o(function(l) {
         return s.subscribe(l);
       });
     }
-    if (AE("iterator") && (i = nu(r, mU1), i))
+    if (AE("iterator") && (i = nu(r, hU1), i))
       return new o(function(l) {
         Ml(function() {
           if (!l.closed) {
-            for (var c = CU1(i.call(r)), u; !(u = c()).done; ) {
+            for (var c = fU1(i.call(r)), u; !(u = c()).done; ) {
               var d = u.value;
               if (l.next(d), l.closed) return;
             }
@@ -126586,6 +126574,18 @@ SE() && Object.defineProperty(Od, /* @__PURE__ */ Symbol("extensions"), {
   },
   configurable: !0
 });
+function yU1(e, t) {
+  if (!e || typeof e != "object")
+    return;
+  const n = t.split(".");
+  let r = e;
+  for (const o of n)
+    if (r && typeof r == "object" && o in r)
+      r = r[o];
+    else
+      return;
+  return r;
+}
 function bU1(e) {
   return new Od((t) => (t.next({
     loading: !0,
@@ -126741,7 +126741,7 @@ function T12(e, {
   ), m2 = O2(() => {
     const Q = S.map((E2) => ({
       ...E2,
-      [zL]: g?.field && fU1(E2, g.field) || void 0
+      [zL]: g?.field && yU1(E2, g.field) || void 0
     }));
     if (g && g.field && y && y.groupBy[g.field]) {
       const E2 = LU1(Q, zL), R2 = g.field, H2 = y.groupBy[R2];
@@ -140963,7 +140963,7 @@ export {
   te3 as fy,
   bE as fz,
   Ya as g,
-  Gr as g$,
+  Oj as g$,
   zq1 as g0,
   X22 as g1,
   Ll as g2,
@@ -140977,30 +140977,30 @@ export {
   IB as gA,
   R8 as gB,
   Do as gC,
-  A5 as gD,
-  zU as gE,
-  FU as gF,
-  ak as gG,
-  Wq1 as gH,
-  ik as gI,
-  ck as gJ,
-  Ku as gK,
-  uk as gL,
-  jn as gM,
-  P32 as gN,
-  U6 as gO,
-  OM as gP,
-  o1 as gQ,
-  d3 as gR,
-  H3 as gS,
-  DM as gT,
-  dj as gU,
-  dB as gV,
-  r12 as gW,
-  aU as gX,
-  _8 as gY,
-  oe3 as gZ,
-  Oj as g_,
+  Od as gD,
+  A5 as gE,
+  zU as gF,
+  FU as gG,
+  ak as gH,
+  Wq1 as gI,
+  ik as gJ,
+  ck as gK,
+  Ku as gL,
+  uk as gM,
+  jn as gN,
+  P32 as gO,
+  U6 as gP,
+  OM as gQ,
+  o1 as gR,
+  d3 as gS,
+  H3 as gT,
+  DM as gU,
+  dj as gV,
+  dB as gW,
+  r12 as gX,
+  aU as gY,
+  _8 as gZ,
+  oe3 as g_,
   qW as ga,
   EU1 as gb,
   AU1 as gc,
@@ -141028,39 +141028,40 @@ export {
   bp2 as gy,
   s33 as gz,
   n12 as h,
-  at as h0,
-  Y9 as h1,
-  f6 as h2,
-  x41 as h3,
-  IJ as h4,
-  I23 as h5,
-  F33 as h6,
-  i33 as h7,
-  R23 as h8,
-  C33 as h9,
-  Kw as ha,
-  R33 as hb,
-  D33 as hc,
-  N33 as hd,
-  XR as he,
-  Y22 as hf,
-  EY1 as hg,
-  Y33 as hh,
-  ie3 as hi,
-  ce3 as hj,
-  le3 as hk,
-  ze1 as hl,
-  QJ as hm,
-  YJ as hn,
-  mJ as ho,
-  Ge1 as hp,
-  ba as hq,
-  zL as hr,
-  _U1 as hs,
-  G33 as ht,
-  X33 as hu,
-  a33 as hv,
-  j23 as hw,
+  Gr as h0,
+  at as h1,
+  Y9 as h2,
+  f6 as h3,
+  x41 as h4,
+  IJ as h5,
+  I23 as h6,
+  F33 as h7,
+  i33 as h8,
+  R23 as h9,
+  C33 as ha,
+  Kw as hb,
+  R33 as hc,
+  D33 as hd,
+  N33 as he,
+  XR as hf,
+  Y22 as hg,
+  EY1 as hh,
+  Y33 as hi,
+  ie3 as hj,
+  ce3 as hk,
+  le3 as hl,
+  ze1 as hm,
+  QJ as hn,
+  YJ as ho,
+  mJ as hp,
+  Ge1 as hq,
+  ba as hr,
+  zL as hs,
+  _U1 as ht,
+  G33 as hu,
+  X33 as hv,
+  a33 as hw,
+  j23 as hx,
   Qa as i,
   rG1 as j,
   f12 as k,

package/dist/ai.js

@@ -1,6 +1,6 @@
-import { D as e, F as r, a as t, e as o, f as i, c as n, d as F, I as C, P as A, b as l, u as d } from "./F0CanvasPanel-BBAGq4mG.js";
+import { D as e, F as r, a as t, e as o, f as i, c as n, d as F, I as C, P as A, b as l, u as d } from "./F0CanvasPanel-Dr6ruMgi.js";
 import { defaultTranslations as m } from "./i18n-provider-defaults.js";
-import { A as c, C as I, h as P, t as v, v as f, x as p, n as T, j as g, r as y, y as S, q as x, s as H, k as V, e as b, g as k, l as w, F as M, i as O, a as D, p as j, m as q, o as z, b as B, f as E, w as L, c as R, d as G, u as J } from "./useChatHistory-CXP7hGgJ.js";
+import { A as c, C as I, h as P, t as v, v as f, x as p, n as T, j as g, r as y, y as S, q as x, s as H, k as V, e as b, g as k, l as w, F as M, i as O, a as D, p as j, m as q, o as z, b as B, f as E, w as L, c as R, d as G, u as J } from "./useChatHistory-RT7UPbrU.js";
 export {
   c as AiChatTranslationsProvider,
   I as ChatSpinner,

package/dist/experimental.d.ts

@@ -1005,6 +1005,14 @@ export declare type BaseDataAdapter<R extends RecordType, Filters extends Filter
      * side-effects on reactive adapters (e.g. Apollo watchQuery).
      */
     exportFetchData?: (options: Options) => FetchReturn | Promise<FetchReturn>;
+    /**
+     * Optional id-relative capability: fetch the immediate neighbours of an
+     * item under the current filters/sortings/search, without loading pages.
+     * Enables detail-page prev/next on direct links / hard refresh, where the
+     * item may not be in any loaded page window. One-shot semantics: when an
+     * Observable is returned, only the first settled emission is consumed.
+     */
+    fetchItemNeighbors?: (options: ItemNeighborsFetchOptions<Filters, Options>) => ItemNeighborsResponse<R> | Promise<ItemNeighborsResponse<R>> | Observable<PromiseState<ItemNeighborsResponse<R>>>;
 };
 
 /**
@@ -5627,6 +5635,42 @@ declare type ItemDefinition = {
     avatar?: AvatarVariant;
 };
 
+/**
+ * Options for an id-relative neighbours fetch. Derived from the adapter's own
+ * fetch options, so extended adapters (e.g. OneDataCollection's, which add
+ * `navigationFilters`) carry their extra context automatically. Pagination is
+ * stripped: the request is relative to an item id, not to a page.
+ */
+export declare type ItemNeighborsFetchOptions<Filters extends FiltersDefinition, Options extends BaseFetchOptions<Filters> = BaseFetchOptions<Filters>> = Omit<Options, "pagination"> & {
+    /** Id of the reference item (as produced by the source's idProvider) */
+    id: ItemNeighborsId;
+};
+
+/**
+ * Identifier used to reference an item in id-relative fetches.
+ * Symbols are excluded on purpose: the id must be serializable so it can
+ * cross a network boundary to a backend.
+ */
+export declare type ItemNeighborsId = string | number;
+
+/**
+ * Result of an id-relative neighbours fetch.
+ *
+ * `previous`/`next` are the immediate neighbours of the reference item under
+ * the given filters/sortings/search, or null at the collection edges. If the
+ * reference item itself does not match the current filters, return
+ * `{ previous: null, next: null }` (optionally with `total`) — consumers
+ * disable navigation in that case.
+ */
+export declare type ItemNeighborsResponse<R> = {
+    previous: R | null;
+    next: R | null;
+    /** 1-indexed position of the reference item in the filtered+sorted collection */
+    position?: number;
+    /** Total number of records matching the current filters/search */
+    total?: number;
+};
+
 export declare function ItemSectionHeader({ item, children, isActive, collapsible, isExpanded, onToggleExpanded, sortable, hideChildrenCounter, canDropInside, onDragOver, onDragLeave, onDrop, currentParentId, draggedItemId, }: TOCItemSectionHeaderProps): JSX_2.Element;
 
 /**
@@ -6856,6 +6900,14 @@ export declare type PaginatedDataAdapter<R extends RecordType, Filters extends F
      * side-effects on reactive adapters (e.g. Apollo watchQuery).
      */
     exportFetchData?: (options: Options) => FetchReturn | Promise<FetchReturn>;
+    /**
+     * Optional id-relative capability: fetch the immediate neighbours of an
+     * item under the current filters/sortings/search, without loading pages.
+     * Enables detail-page prev/next on direct links / hard refresh, where the
+     * item may not be in any loaded page window. One-shot semantics: when an
+     * Observable is returned, only the first settled emission is consumed.
+     */
+    fetchItemNeighbors?: (options: ItemNeighborsFetchOptions<Filters, Options>) => ItemNeighborsResponse<R> | Promise<ItemNeighborsResponse<R>> | Observable<PromiseState<ItemNeighborsResponse<R>>>;
 };
 
 export declare type PaginatedFetchOptions<Filters extends FiltersDefinition> = BaseFetchOptions<Filters> & {

package/dist/experimental.js

@@ -1,9 +1,9 @@
-import { g as ua, B as fa, h as ma, i as ha, j as Lt, k as Te, l as ga, m as b, n as J, o as pe, u as ie, T as pa, p as ba, q as xa, R as va, r as wa, s as re, t as ya, v as bt, w as it, x as $e, A as _e, y as Na, z as Ca, C as M, E as ka, G as Ia, H as ve, J as sn, K as Sa, L as Fa, M as V, N as on, S as D, O as we, Q as Aa, U as La, V as Ea, W as Oa, X as _a, Y as ke, Z as cn, _ as Da, $ as be, a0 as We, a1 as Ta, d as dn, a2 as Ce, a3 as Pa, a4 as un, a5 as ne, a6 as q, a7 as fn, a8 as mn, a9 as za, aa as hn, ab as me, ac as ee, ad as Ba, ae as Ra, af as $a, ag as Wa, ah as ge, ai as Ue, aj as Ma, ak as ja, al as Va, am as Ha, an as Ge, ao as gn, ap as Ua, aq as Ga, ar as Ka, as as Me, at as qa, au as Ya, av as Za, aw as Ja, ax as Xa, ay as Qa, az as er, aA as tr, aB as nr, aC as ar, aD as st, aE as pn, aF as ot, aG as bn, aH as rr, aI as lr, aJ as ir, aK as sr, aL as or, aM as Ke, aN as xt, aO as ct, aP as xn, aQ as cr, aR as vn, aS as dr, aT as ur, aU as fr, aV as Oe, aW as mr, aX as hr, aY as Pe, aZ as Et, a_ as dt, a$ as gr, b0 as pr, a as br, b as xr, b1 as wn, b2 as vr, f as wr, F as yr, b3 as Nr, b4 as yn, b5 as Cr, b6 as Nn, b7 as Cn, b8 as kr, b9 as Ir, ba as Sr, bb as Fr, bc as Ar, bd as Lr, be as Er, bf as Or, bg as _r, bh as kn, bi as Dr, bj as ue, bk as vt, bl as wt, bm as yt, bn as In, bo as Nt, bp as Sn, bq as Fn, br as Tr, bs as Pr, bt as zr, bu as Br, bv as Rr, bw as $r, bx as Wr, by as Mr, bz as Ot, bA as jr, bB as Vr, bC as _t, bD as Dt, bE as Tt, bF as Hr, bG as Ur, bH as Gr, bI as Kr, bJ as An, bK as qr, bL as Yr } from "./F0CanvasPanel-BBAGq4mG.js";
-import { bX as Wc, bW as Mc, c7 as jc, bT as Vc, bU as Hc, bM as Uc, bN as Gc, bO as Kc, c8 as qc, bV as Yc, c3 as Zc, c4 as Jc, bP as Xc, bZ as Qc, bY as ed, bQ as td, bR as nd, c5 as ad, c9 as rd, c6 as ld, c2 as id, b$ as sd, c1 as od, b_ as cd, bS as dd, c0 as ud } from "./F0CanvasPanel-BBAGq4mG.js";
+import { g as ua, B as fa, h as ma, i as ha, j as Lt, k as Te, l as ga, m as b, n as J, o as pe, u as ie, T as pa, p as ba, q as xa, R as va, r as wa, s as re, t as ya, v as bt, w as it, x as $e, A as _e, y as Na, z as Ca, C as M, E as ka, G as Ia, H as ve, J as sn, K as Sa, L as Fa, M as V, N as on, S as D, O as we, Q as Aa, U as La, V as Ea, W as Oa, X as _a, Y as ke, Z as cn, _ as Da, $ as be, a0 as We, a1 as Ta, d as dn, a2 as Ce, a3 as Pa, a4 as un, a5 as ne, a6 as q, a7 as fn, a8 as mn, a9 as za, aa as hn, ab as me, ac as ee, ad as Ba, ae as Ra, af as $a, ag as Wa, ah as ge, ai as Ue, aj as Ma, ak as ja, al as Va, am as Ha, an as Ge, ao as gn, ap as Ua, aq as Ga, ar as Ka, as as Me, at as qa, au as Ya, av as Za, aw as Ja, ax as Xa, ay as Qa, az as er, aA as tr, aB as nr, aC as ar, aD as st, aE as pn, aF as ot, aG as bn, aH as rr, aI as lr, aJ as ir, aK as sr, aL as or, aM as Ke, aN as xt, aO as ct, aP as xn, aQ as cr, aR as vn, aS as dr, aT as ur, aU as fr, aV as Oe, aW as mr, aX as hr, aY as Pe, aZ as Et, a_ as dt, a$ as gr, b0 as pr, a as br, b as xr, b1 as wn, b2 as vr, f as wr, F as yr, b3 as Nr, b4 as yn, b5 as Cr, b6 as Nn, b7 as Cn, b8 as kr, b9 as Ir, ba as Sr, bb as Fr, bc as Ar, bd as Lr, be as Er, bf as Or, bg as _r, bh as kn, bi as Dr, bj as ue, bk as vt, bl as wt, bm as yt, bn as In, bo as Nt, bp as Sn, bq as Fn, br as Tr, bs as Pr, bt as zr, bu as Br, bv as Rr, bw as $r, bx as Wr, by as Mr, bz as Ot, bA as jr, bB as Vr, bC as _t, bD as Dt, bE as Tt, bF as Hr, bG as Ur, bH as Gr, bI as Kr, bJ as An, bK as qr, bL as Yr } from "./F0CanvasPanel-Dr6ruMgi.js";
+import { bX as Wc, bW as Mc, c7 as jc, bT as Vc, bU as Hc, bM as Uc, bN as Gc, bO as Kc, c8 as qc, bV as Yc, c3 as Zc, c4 as Jc, bP as Xc, bZ as Qc, bY as ed, bQ as td, bR as nd, c5 as ad, c9 as rd, c6 as ld, c2 as id, b$ as sd, c1 as od, b_ as cd, bS as dd, c0 as ud } from "./F0CanvasPanel-Dr6ruMgi.js";
 import { jsx as e, jsxs as o, Fragment as G } from "react/jsx-runtime";
 import se, { forwardRef as H, useRef as W, useTransition as Zr, useState as O, useLayoutEffect as Ln, useId as ut, useContext as Ie, createContext as qe, useEffect as $, useCallback as Q, useMemo as K, Fragment as Jr, isValidElement as Xr, cloneElement as En, Children as On } from "react";
-import { C as Qr, P as el, a as _n, M as tl, R as Pt, b as Dn, u as nl, r as al, c as rl, d as ll, e as il, f as Tn, S as sl, A as ol, B as cl, L as dl, g as ul, V as fl, h as ml, i as hl, j as gl, O as pl } from "./readDataCollectionStorage-CSWd6RWv.js";
-import { o as md, p as hd, m as gd, E as pd, q as bd, x as xd, a6 as vd, D as wd, n as yd, J as Nd, F as Cd, W as kd, K as Id, H as Sd, ac as Fd, I as Ad, X as Ld, Y as Ed, s as Od, a8 as _d, a9 as Dd, a7 as Td, aa as Pd, N as zd, Z as Bd, a3 as Rd, a5 as $d, t as Wd, w as Md, y as jd, Q as Vd, ab as Hd, U as Ud, T as Gd, v as Kd, z as qd, k as Yd, l as Zd, $ as Jd, a0 as Xd, a4 as Qd, G as eu, a1 as tu, _ as nu, a2 as au } from "./readDataCollectionStorage-CSWd6RWv.js";
+import { C as Qr, P as el, a as _n, M as tl, R as Pt, b as Dn, u as nl, r as al, c as rl, d as ll, e as il, f as Tn, S as sl, A as ol, B as cl, L as dl, g as ul, V as fl, h as ml, i as hl, j as gl, O as pl } from "./readDataCollectionStorage-DyBXGaXR.js";
+import { o as md, p as hd, m as gd, E as pd, q as bd, x as xd, a6 as vd, D as wd, n as yd, J as Nd, F as Cd, W as kd, K as Id, H as Sd, ac as Fd, I as Ad, X as Ld, Y as Ed, s as Od, a8 as _d, a9 as Dd, a7 as Td, aa as Pd, N as zd, Z as Bd, a3 as Rd, a5 as $d, t as Wd, w as Md, y as jd, Q as Vd, ab as Hd, U as Ud, T as Gd, v as Kd, z as qd, k as Yd, l as Zd, $ as Jd, a0 as Xd, a4 as Qd, G as eu, a1 as tu, _ as nu, a2 as au } from "./readDataCollectionStorage-DyBXGaXR.js";
 const bl = ua("Search", [
   ["circle", { cx: "11", cy: "11", r: "8", key: "4ej97u" }],
   ["path", { d: "m21 21-4.3-4.3", key: "1qie3q" }]

package/dist/f0.d.ts

@@ -1416,6 +1416,14 @@ export declare type BaseDataAdapter<R extends RecordType, Filters extends Filter
      * side-effects on reactive adapters (e.g. Apollo watchQuery).
      */
     exportFetchData?: (options: Options) => FetchReturn | Promise<FetchReturn>;
+    /**
+     * Optional id-relative capability: fetch the immediate neighbours of an
+     * item under the current filters/sortings/search, without loading pages.
+     * Enables detail-page prev/next on direct links / hard refresh, where the
+     * item may not be in any loaded page window. One-shot semantics: when an
+     * Observable is returned, only the first settled emission is consumed.
+     */
+    fetchItemNeighbors?: (options: ItemNeighborsFetchOptions<Filters, Options>) => ItemNeighborsResponse<R> | Promise<ItemNeighborsResponse<R>> | Observable<PromiseState<ItemNeighborsResponse<R>>>;
 };
 
 /**
@@ -11734,6 +11742,44 @@ declare type ItemDefinition = {
     avatar?: AvatarVariant;
 };
 
+/**
+ * Options for an id-relative neighbours fetch. Derived from the adapter's own
+ * fetch options, so extended adapters (e.g. OneDataCollection's, which add
+ * `navigationFilters`) carry their extra context automatically. Pagination is
+ * stripped: the request is relative to an item id, not to a page.
+ */
+export declare type ItemNeighborsFetchOptions<Filters extends FiltersDefinition, Options extends BaseFetchOptions<Filters> = BaseFetchOptions<Filters>> = Omit<Options, "pagination"> & {
+    /** Id of the reference item (as produced by the source's idProvider) */
+    id: ItemNeighborsId;
+};
+
+/**
+ * Identifier used to reference an item in id-relative fetches.
+ * Symbols are excluded on purpose: the id must be serializable so it can
+ * cross a network boundary to a backend.
+ */
+export declare type ItemNeighborsId = string | number;
+
+/**
+ * Result of an id-relative neighbours fetch.
+ *
+ * `previous`/`next` are the immediate neighbours of the reference item under
+ * the given filters/sortings/search, or null at the collection edges. If the
+ * reference item itself does not match the current filters, return
+ * `{ previous: null, next: null }` (optionally with `total`) — consumers
+ * disable navigation in that case.
+ */
+export declare type ItemNeighborsResponse<R> = {
+    previous: R | null;
+    next: R | null;
+    /** 1-indexed position of the reference item in the filtered+sorted collection */
+    position?: number;
+    /** Total number of records matching the current filters/search */
+    total?: number;
+};
+
+export declare type ItemNeighborsResult<R> = ItemNeighborsResponse<R> | Promise<ItemNeighborsResponse<R>> | Observable<PromiseState<ItemNeighborsResponse<R>>>;
+
 /**
  * Profile data for a job posting entity (ATS opening), resolved asynchronously
  * and displayed in the entity reference hover card.
@@ -12996,6 +13042,14 @@ export declare type PaginatedDataAdapter<R extends RecordType, Filters extends F
      * side-effects on reactive adapters (e.g. Apollo watchQuery).
      */
     exportFetchData?: (options: Options) => FetchReturn | Promise<FetchReturn>;
+    /**
+     * Optional id-relative capability: fetch the immediate neighbours of an
+     * item under the current filters/sortings/search, without loading pages.
+     * Enables detail-page prev/next on direct links / hard refresh, where the
+     * item may not be in any loaded page window. One-shot semantics: when an
+     * Observable is returned, only the first settled emission is consumed.
+     */
+    fetchItemNeighbors?: (options: ItemNeighborsFetchOptions<Filters, Options>) => ItemNeighborsResponse<R> | Promise<ItemNeighborsResponse<R>> | Observable<PromiseState<ItemNeighborsResponse<R>>>;
 };
 
 export declare type PaginatedFetchOptions<Filters extends FiltersDefinition> = BaseFetchOptions<Filters> & {
@@ -13801,6 +13855,23 @@ export declare interface ResolvedStepAnswer {
     cancelled?: boolean;
 }
 
+/**
+ * Normalizes the three `fetchItemNeighbors` return channels (sync value,
+ * Promise, Observable of PromiseState) into a single one-shot Promise.
+ *
+ * Observables are consumed one-shot: the first emission carrying `data`
+ * resolves, the first emission carrying `error` rejects, and the
+ * subscription is closed either way — live updates are intentionally out of
+ * scope for neighbour resolution.
+ *
+ * `cancel()` unsubscribes/abandons the request: the returned promise then
+ * never settles, so a cancelled request can never reach consumer state.
+ */
+export declare function resolveItemNeighbors<R>(result: ItemNeighborsResult<R>): {
+    promise: Promise<ItemNeighborsResponse<R>>;
+    cancel: () => void;
+};
+
 /**
  * Locates the active item and its immediate neighbours within the currently
  * loaded records ("the window"). Pure — the single place neighbour resolution
@@ -15794,6 +15865,56 @@ export declare const useGroups: <R extends RecordType>(groups: GroupRecord<R>[],
     setGroupOpen: (key: string, open: boolean) => void;
 };
 
+/**
+ * Resolves the previous/next neighbours of an item through the adapter's
+ * optional id-relative `fetchItemNeighbors` capability.
+ *
+ * Built for detail-page navigation on direct links: when the active item is
+ * not in any loaded page window, this asks the backend for its immediate
+ * neighbours (plus position/total for the counter) under the current
+ * filters/sortings/search instead of walking pages.
+ *
+ * Semantics:
+ * - `neighbors` only ever reflects the current `{id, filters, sortings,
+ *   search}` — stale responses from superseded requests are dropped.
+ * - Responses are cached per request key, so navigating back and forth
+ *   between already-visited ids is instant. The cache is cleared whenever
+ *   filters/sortings/search change; errors are never cached.
+ * - When the capability is absent (`isSupported: false`), disabled, or the
+ *   id is null, nothing is fetched and `neighbors` stays null — consumers
+ *   keep their fallback behaviour.
+ */
+export declare function useItemNeighbors<R extends RecordType, Filters extends FiltersDefinition>({ dataAdapter, id, filters, sortings, search, enabled, onError, }: UseItemNeighborsOptions<R, Filters>): UseItemNeighborsReturn<R>;
+
+export declare interface UseItemNeighborsOptions<R extends RecordType, Filters extends FiltersDefinition> {
+    /** The adapter that may implement the `fetchItemNeighbors` capability */
+    dataAdapter: DataAdapter<R, Filters>;
+    /** Active item id. Null disables resolution (symbol ids cannot be used) */
+    id: ItemNeighborsId | null;
+    /** Current filters — same values `fetchData` receives */
+    filters: FiltersState<Filters>;
+    /** Current sortings — same composed array `fetchData` receives */
+    sortings: SortingsStateMultiple;
+    /** Current search — same value `fetchData` receives */
+    search?: string;
+    /**
+     * Gate: resolve only while true (e.g. only when the snapshot path failed
+     * to locate the item in the loaded window).
+     * @default true
+     */
+    enabled?: boolean;
+    onError?: (error: DataError) => void;
+}
+
+export declare interface UseItemNeighborsReturn<R extends RecordType> {
+    /** True when the adapter implements `fetchItemNeighbors` */
+    isSupported: boolean;
+    /** Resolved neighbours for the CURRENT id+context, or null while unresolved */
+    neighbors: ItemNeighborsResponse<R> | null;
+    isResolving: boolean;
+    error: DataError | null;
+}
+
 export declare const usePrivacyMode: () => {
     enabled: boolean;
     enable: () => void;