@lunora/client 1.0.0-alpha.6 → 1.0.0-alpha.60

package/dist/packem_shared/wire-codec-D4iww4NV.mjs

@@ -0,0 +1 @@
+const A=e=>{let t="";for(let o=0;o<e.length;o+=32768)t+=String.fromCharCode(...e.subarray(o,o+32768));return btoa(t)},E=e=>{const t=atob(e),f=new Uint8Array(t.length);for(let o=0;o<t.length;o+=1)f[o]=t.codePointAt(o)??0;return f},i="$lunora.wire$";const d="__proto__",m={BigInt64Array,BigUint64Array,Float32Array,Float64Array,Int8Array,Int16Array,Int32Array,Uint8Array,Uint8ClampedArray,Uint16Array,Uint32Array},w={Error,EvalError,RangeError,ReferenceError,SyntaxError,TypeError,URIError},p=e=>{if(e===null||typeof e!="object")return!1;const t=Object.getPrototypeOf(e);return t===null||t===Object.prototype},u=(e,t=0)=>{if(t>64)throw new RangeError("wire-codec: value nesting exceeds the 64-level limit");if(e===void 0)return[i,"undefined"];if(e===null)return null;const f=typeof e;if(f==="bigint")return[i,"bigint",e.toString()];if(f==="number"){const r=e;return Number.isNaN(r)?[i,"nan"]:r===1/0?[i,"inf"]:r===-1/0?[i,"-inf"]:r}if(f!=="object")return e;if(e instanceof Date)return[i,"date",u(e.getTime(),t+1)];if(e instanceof Error){const r=e,n={};for(const a of Object.keys(r))r[a]!==void 0&&(n[a]=u(r[a],t+1));const c=[i,"error",r.name,r.message,n];return r.cause!==void 0&&c.push(u(r.cause,t+1)),c}if(e instanceof URL)return[i,"url",e.href];if(e instanceof Map)return[i,"map",[...e.entries()].map(([r,n])=>[u(r,t+1),u(n,t+1)])];if(e instanceof Set)return[i,"set",[...e].map(r=>u(r,t+1))];if(e instanceof ArrayBuffer)return[i,"bytes",A(new Uint8Array(e)),"ArrayBuffer"];if(ArrayBuffer.isView(e)){const r=e,n=r.constructor.name,c=new Uint8Array(r.buffer,r.byteOffset,r.byteLength);return n==="Uint8Array"?[i,"bytes",A(c)]:[i,"bytes",A(c),n]}if(Array.isArray(e)){const r=e.map(n=>u(n,t+1));return r.length>0&&r[0]===i?[i,"arr",r]:r}if(!p(e)){const r=e.constructor?.name??"value";throw new TypeError(`wire-codec: cannot encode a ${r} over the Lunora wire — only plain objects, arrays, and the supported built-ins (Date, Error, URL, Map, Set, ArrayBuffer/typed arrays, bigint) round-trip`)}const o=e,s={};for(const r of Object.keys(o)){const n=o[r];if(n===void 0)continue;const c=u(n,t+1);r===d?Object.defineProperty(s,r,{configurable:!0,enumerable:!0,value:c,writable:!0}):s[r]=c}return s},y=(e,t=0)=>{if(t>64)throw new RangeError("wire-codec: value nesting exceeds the 64-level limit");if(e===null||typeof e!="object")return e;if(Array.isArray(e)){if(e[0]===i)switch(e[1]){case"-inf":return-1/0;case"arr":return e[2].map(r=>y(r,t+1));case"bigint":{const r=e[2];if(typeof r!="string"||r.length>1024||!/^-?\d+$/.test(r))throw new RangeError("wire-codec: invalid or over-long bigint (max 1024 digits)");return BigInt(r)}case"date":return new Date(y(e[2],t+1));case"map":return new Map(e[2].map(([r,n])=>[y(r,t+1),y(n,t+1)]));case"set":return new Set(e[2].map(r=>y(r,t+1)));case"url":return new URL(e[2]);case"error":{const r=e[2],n=e[3],c=(Object.hasOwn(w,r)?w[r]:void 0)??Error,a=new c(n);a.name!==r&&Object.defineProperty(a,"name",{configurable:!0,value:r,writable:!0});const g=y(e[4],t+1);for(const b of Object.keys(g))b===d?Object.defineProperty(a,b,{configurable:!0,enumerable:!0,value:g[b],writable:!0}):a[b]=g[b];return e.length>5&&Object.defineProperty(a,"cause",{configurable:!0,value:y(e[5],t+1),writable:!0}),a}case"bytes":{const r=E(e[2]),n=e[3]??"Uint8Array";if(n==="ArrayBuffer")return r.buffer.byteLength===r.byteLength?r.buffer:r.slice().buffer;const c=Object.hasOwn(m,n)?m[n]:void 0;return c?new c(r.slice().buffer):r}case"inf":return 1/0;case"nan":return Number.NaN;case"undefined":return;default:return e.map(r=>y(r,t+1))}return e.map(s=>y(s,t+1))}const f=e,o={};for(const s of Object.keys(f)){const r=y(f[s],t+1);s===d?Object.defineProperty(o,s,{configurable:!0,enumerable:!0,value:r,writable:!0}):o[s]=r}return o};export{y as d,u as e,p as i};

package/dist/packem_shared/wire-key-BOdKmpG3.mjs

@@ -0,0 +1 @@
+import{e as a}from"./wire-codec-D4iww4NV.mjs";const b=/["\\\u0000-\u001F\uD800-\uDFFF]/,y=t=>b.test(t)?JSON.stringify(t):`"${t}"`,i=t=>{if(t===void 0)return"null";if(typeof t=="bigint")throw new TypeError("stableStringify: cannot use a bigint in a stable JSON cache key — pass it as a string, or use stableWireKey");if(typeof t=="number"){if(Number.isNaN(t))return"nan";if(t===1/0)return"inf";if(t===-1/0)return"-inf";if(Object.is(t,-0))return"-0"}if(typeof t=="string")return y(t);if(t===null||typeof t!="object")return JSON.stringify(t);if(Array.isArray(t)){let r="[";for(let e=0;e<t.length;e++)e>0&&(r+=","),r+=i(t[e]);return r+"]"}const o=Object.getPrototypeOf(t);if(o!==null&&o!==Object.prototype){const r=t.constructor?.name??"value";throw new TypeError(`stableStringify: cannot use a ${r} in a stable JSON cache key — only plain objects, arrays, and JSON primitives are supported (wire-typed values key via stableWireKey)`)}const s=t,c=Object.keys(s).sort();let n="{",f=!0;for(const r of c){const e=s[r];e!==void 0&&(f?f=!1:n+=",",n+=y(r),n+=":",n+=i(e))}return n+"}"},u=t=>i(a(t));export{u as s};

package/dist/pagination/index.d.mts

@@ -1,13 +1,13 @@
 /**
-* `@lunora/client/pagination` — the framework-agnostic pagination state machine
-* shared by every Lunora UI adapter (React, Vue, Svelte, Solid).
-*
-* Owns cursor tracking, page-size rebalancing (split/join), `initialPages`,
-* `rebalance`, and the shared types (`Page`, `PaginationResult`,
-* `PaginationStatus`, `PaginatedCoreResult`). Nothing here imports a UI
-* framework — each adapter wires the pure functions into its own reactive
-* primitives.
-*/
+ * `@lunora/client/pagination` — the framework-agnostic pagination state machine
+ * shared by every Lunora UI adapter (React, Vue, Svelte, Solid).
+ *
+ * Owns cursor tracking, page-size rebalancing (split/join), `initialPages`,
+ * `rebalance`, and the shared types (`Page`, `PaginationResult`,
+ * `PaginationStatus`, `PaginatedCoreResult`). Nothing here imports a UI
+ * framework — each adapter wires the pure functions into its own reactive
+ * primitives.
+ */
 /** Grow factor: a bounded page is split when it exceeds this multiple of its target size. */
 declare const SPLIT_FACTOR = 2;
 /** Shrink factor: a bounded page with a neighbour is joined when it falls below this multiple of its target size. */
@@ -24,20 +24,20 @@ interface PaginationResult<T = unknown> {
   isDone: boolean;
   page: T[];
   /**
-  * Reactive-pagination only: the midpoint cursor of a bounded
-  * `(cursor, endCursor]` page, used to split an over-grown page into two
-  * adjacent ranges. Absent on legacy (open-ended) pages.
-  */
+   * Reactive-pagination only: the midpoint cursor of a bounded
+   * `(cursor, endCursor]` page, used to split an over-grown page into two
+   * adjacent ranges. Absent on legacy (open-ended) pages.
+   */
   splitCursor?: null | string;
 }
 /**
-* Lifecycle of a `usePaginatedQuery` feed.
-*
-* - `LoadingFirstPage` — the first page is in flight; `results` is empty.
-* - `CanLoadMore` — the loaded tail has a cursor; calling `loadMore` fetches the next page.
-* - `LoadingMore` — a `loadMore` page is in flight; earlier results stay visible.
-* - `Exhausted` — every page has loaded and the server reported `isDone`.
-*/
+ * Lifecycle of a `usePaginatedQuery` feed.
+ *
+ * - `LoadingFirstPage` — the first page is in flight; `results` is empty.
+ * - `CanLoadMore` — the loaded tail has a cursor; calling `loadMore` fetches the next page.
+ * - `LoadingMore` — a `loadMore` page is in flight; earlier results stay visible.
+ * - `Exhausted` — every page has loaded and the server reported `isDone`.
+ */
 type PaginationStatus = "CanLoadMore" | "Exhausted" | "LoadingFirstPage" | "LoadingMore";
 interface PaginatedCoreResult<T> {
   /** Request another page off the open-ended tail. A no-op unless `status === "CanLoadMore"`. */
@@ -49,34 +49,34 @@ interface PaginatedCoreResult<T> {
 /** First-page seed: a single open-ended range starting at the feed head. */
 declare const initialPages: (numberItems: number) => Page[];
 /**
-* Run the SPLIT/JOIN maintenance pass over the current page list given freshly
-* resolved results. Returns a new page list when a boundary changed, or
-* `undefined` when the layout is already balanced (so the caller can skip a
-* setState).
-*
-* Only ONE structural edit is applied per pass (the first split or join found),
-* letting the subsequent re-render's resolved results drive the next pass — this
-* keeps each transition observable and avoids reasoning about several
-* simultaneous boundary moves.
-*/
+ * Run the SPLIT/JOIN maintenance pass over the current page list given freshly
+ * resolved results. Returns a new page list when a boundary changed, or
+ * `undefined` when the layout is already balanced (so the caller can skip a
+ * setState).
+ *
+ * Only ONE structural edit is applied per pass (the first split or join found),
+ * letting the subsequent re-render's resolved results drive the next pass — this
+ * keeps each transition observable and avoids reasoning about several
+ * simultaneous boundary moves.
+ */
 declare const rebalance: (pages: Page[], results: (PaginationResult | undefined)[]) => Page[] | undefined;
 /**
-* Derive the feed `status` and the next-page cursor from the current page list
-* and resolved page results. Framework adapters call this each render/effect to
-* compute what to expose to callers.
-*/
+ * Derive the feed `status` and the next-page cursor from the current page list
+ * and resolved page results. Framework adapters call this each render/effect to
+ * compute what to expose to callers.
+ */
 declare const derivePaginationStatus: <T>(skipped: boolean, pageResults: (PaginationResult<T> | undefined)[]) => {
   nextCursor: null | string | undefined;
   status: PaginationStatus;
 };
 /**
-* Apply a `loadMore` to the current page list. Pins the open-ended tail at
-* `cursor` (making it a fixed bounded range) and appends a fresh open-ended
-* page starting at `cursor`. The shared boundary keeps the feed gap- and
-* dup-free.
-*
-* Returns the new page list, or `undefined` when the given `cursor` is not
-* valid (null or undefined — caller should no-op).
-*/
+ * Apply a `loadMore` to the current page list. Pins the open-ended tail at
+ * `cursor` (making it a fixed bounded range) and appends a fresh open-ended
+ * page starting at `cursor`. The shared boundary keeps the feed gap- and
+ * dup-free.
+ *
+ * Returns the new page list, or `undefined` when the given `cursor` is not
+ * valid (null or undefined — caller should no-op).
+ */
 declare const applyLoadMore: (pages: Page[], cursor: null | string | undefined, numberItems: number) => Page[] | undefined;
 export { JOIN_FACTOR, type Page, type PaginatedCoreResult, type PaginationResult, type PaginationStatus, SPLIT_FACTOR, applyLoadMore, derivePaginationStatus, initialPages, rebalance };

package/dist/pagination/index.d.ts

@@ -1,13 +1,13 @@
 /**
-* `@lunora/client/pagination` — the framework-agnostic pagination state machine
-* shared by every Lunora UI adapter (React, Vue, Svelte, Solid).
-*
-* Owns cursor tracking, page-size rebalancing (split/join), `initialPages`,
-* `rebalance`, and the shared types (`Page`, `PaginationResult`,
-* `PaginationStatus`, `PaginatedCoreResult`). Nothing here imports a UI
-* framework — each adapter wires the pure functions into its own reactive
-* primitives.
-*/
+ * `@lunora/client/pagination` — the framework-agnostic pagination state machine
+ * shared by every Lunora UI adapter (React, Vue, Svelte, Solid).
+ *
+ * Owns cursor tracking, page-size rebalancing (split/join), `initialPages`,
+ * `rebalance`, and the shared types (`Page`, `PaginationResult`,
+ * `PaginationStatus`, `PaginatedCoreResult`). Nothing here imports a UI
+ * framework — each adapter wires the pure functions into its own reactive
+ * primitives.
+ */
 /** Grow factor: a bounded page is split when it exceeds this multiple of its target size. */
 declare const SPLIT_FACTOR = 2;
 /** Shrink factor: a bounded page with a neighbour is joined when it falls below this multiple of its target size. */
@@ -24,20 +24,20 @@ interface PaginationResult<T = unknown> {
   isDone: boolean;
   page: T[];
   /**
-  * Reactive-pagination only: the midpoint cursor of a bounded
-  * `(cursor, endCursor]` page, used to split an over-grown page into two
-  * adjacent ranges. Absent on legacy (open-ended) pages.
-  */
+   * Reactive-pagination only: the midpoint cursor of a bounded
+   * `(cursor, endCursor]` page, used to split an over-grown page into two
+   * adjacent ranges. Absent on legacy (open-ended) pages.
+   */
   splitCursor?: null | string;
 }
 /**
-* Lifecycle of a `usePaginatedQuery` feed.
-*
-* - `LoadingFirstPage` — the first page is in flight; `results` is empty.
-* - `CanLoadMore` — the loaded tail has a cursor; calling `loadMore` fetches the next page.
-* - `LoadingMore` — a `loadMore` page is in flight; earlier results stay visible.
-* - `Exhausted` — every page has loaded and the server reported `isDone`.
-*/
+ * Lifecycle of a `usePaginatedQuery` feed.
+ *
+ * - `LoadingFirstPage` — the first page is in flight; `results` is empty.
+ * - `CanLoadMore` — the loaded tail has a cursor; calling `loadMore` fetches the next page.
+ * - `LoadingMore` — a `loadMore` page is in flight; earlier results stay visible.
+ * - `Exhausted` — every page has loaded and the server reported `isDone`.
+ */
 type PaginationStatus = "CanLoadMore" | "Exhausted" | "LoadingFirstPage" | "LoadingMore";
 interface PaginatedCoreResult<T> {
   /** Request another page off the open-ended tail. A no-op unless `status === "CanLoadMore"`. */
@@ -49,34 +49,34 @@ interface PaginatedCoreResult<T> {
 /** First-page seed: a single open-ended range starting at the feed head. */
 declare const initialPages: (numberItems: number) => Page[];
 /**
-* Run the SPLIT/JOIN maintenance pass over the current page list given freshly
-* resolved results. Returns a new page list when a boundary changed, or
-* `undefined` when the layout is already balanced (so the caller can skip a
-* setState).
-*
-* Only ONE structural edit is applied per pass (the first split or join found),
-* letting the subsequent re-render's resolved results drive the next pass — this
-* keeps each transition observable and avoids reasoning about several
-* simultaneous boundary moves.
-*/
+ * Run the SPLIT/JOIN maintenance pass over the current page list given freshly
+ * resolved results. Returns a new page list when a boundary changed, or
+ * `undefined` when the layout is already balanced (so the caller can skip a
+ * setState).
+ *
+ * Only ONE structural edit is applied per pass (the first split or join found),
+ * letting the subsequent re-render's resolved results drive the next pass — this
+ * keeps each transition observable and avoids reasoning about several
+ * simultaneous boundary moves.
+ */
 declare const rebalance: (pages: Page[], results: (PaginationResult | undefined)[]) => Page[] | undefined;
 /**
-* Derive the feed `status` and the next-page cursor from the current page list
-* and resolved page results. Framework adapters call this each render/effect to
-* compute what to expose to callers.
-*/
+ * Derive the feed `status` and the next-page cursor from the current page list
+ * and resolved page results. Framework adapters call this each render/effect to
+ * compute what to expose to callers.
+ */
 declare const derivePaginationStatus: <T>(skipped: boolean, pageResults: (PaginationResult<T> | undefined)[]) => {
   nextCursor: null | string | undefined;
   status: PaginationStatus;
 };
 /**
-* Apply a `loadMore` to the current page list. Pins the open-ended tail at
-* `cursor` (making it a fixed bounded range) and appends a fresh open-ended
-* page starting at `cursor`. The shared boundary keeps the feed gap- and
-* dup-free.
-*
-* Returns the new page list, or `undefined` when the given `cursor` is not
-* valid (null or undefined — caller should no-op).
-*/
+ * Apply a `loadMore` to the current page list. Pins the open-ended tail at
+ * `cursor` (making it a fixed bounded range) and appends a fresh open-ended
+ * page starting at `cursor`. The shared boundary keeps the feed gap- and
+ * dup-free.
+ *
+ * Returns the new page list, or `undefined` when the given `cursor` is not
+ * valid (null or undefined — caller should no-op).
+ */
 declare const applyLoadMore: (pages: Page[], cursor: null | string | undefined, numberItems: number) => Page[] | undefined;
 export { JOIN_FACTOR, type Page, type PaginatedCoreResult, type PaginationResult, type PaginationStatus, SPLIT_FACTOR, applyLoadMore, derivePaginationStatus, initialPages, rebalance };

package/dist/pagination/index.mjs

@@ -1,61 +1 @@
-const SPLIT_FACTOR = 2;
-const JOIN_FACTOR = 0.5;
-const initialPages = (numberItems) => [
-  // eslint-disable-next-line unicorn/no-null -- `lower: null` is the feed head, `upper: null` the open-ended tail — both are wire-shape cursors.
-  { lower: null, numItems: numberItems, upper: null }
-];
-const rebalance = (pages, results) => {
-  for (const [index, page] of pages.entries()) {
-    if (page.upper === null) {
-      continue;
-    }
-    const result = results[index];
-    if (!result) {
-      continue;
-    }
-    const size = result.page.length;
-    if (size > SPLIT_FACTOR * page.numItems && result.splitCursor) {
-      const split = result.splitCursor;
-      const next = [...pages];
-      next.splice(index, 1, { lower: page.lower, numItems: page.numItems, upper: split }, { lower: split, numItems: page.numItems, upper: page.upper });
-      return next;
-    }
-    if (size < JOIN_FACTOR * page.numItems && index + 1 < pages.length) {
-      const neighbour = pages[index + 1];
-      if (!neighbour) {
-        continue;
-      }
-      const next = [...pages];
-      next.splice(index, 2, { lower: page.lower, numItems: page.numItems, upper: neighbour.upper });
-      return next;
-    }
-  }
-  return void 0;
-};
-const derivePaginationStatus = (skipped, pageResults) => {
-  if (skipped || !pageResults[0]) {
-    return { nextCursor: void 0, status: "LoadingFirstPage" };
-  }
-  const tail = pageResults.at(-1);
-  if (!tail) {
-    return { nextCursor: void 0, status: "LoadingMore" };
-  }
-  if (tail.isDone || tail.continueCursor === null) {
-    return { nextCursor: void 0, status: "Exhausted" };
-  }
-  return { nextCursor: tail.continueCursor, status: "CanLoadMore" };
-};
-const applyLoadMore = (pages, cursor, numberItems) => {
-  if (cursor === void 0 || cursor === null) {
-    return void 0;
-  }
-  const next = [...pages];
-  const tail = next.at(-1);
-  if (tail) {
-    next[next.length - 1] = { lower: tail.lower, numItems: tail.numItems, upper: cursor };
-  }
-  next.push({ lower: cursor, numItems: numberItems, upper: null });
-  return next;
-};
-
-export { JOIN_FACTOR, SPLIT_FACTOR, applyLoadMore, derivePaginationStatus, initialPages, rebalance };
+const l=2,m=.5,p=e=>[{lower:null,numItems:e,upper:null}],c=(e,r)=>{for(const[n,t]of e.entries()){if(t.upper===null)continue;const o=r[n];if(!o)continue;const i=o.page.length;if(i>2*t.numItems&&o.splitCursor){const u=o.splitCursor,s=[...e];return s.splice(n,1,{lower:t.lower,numItems:t.numItems,upper:u},{lower:u,numItems:t.numItems,upper:t.upper}),s}if(i<.5*t.numItems&&n+1<e.length){const u=e[n+1];if(!u)continue;const s=[...e];return s.splice(n,2,{lower:t.lower,numItems:t.numItems,upper:u.upper}),s}}},a=(e,r)=>{if(e||!r[0])return{nextCursor:void 0,status:"LoadingFirstPage"};const n=r.at(-1);return n?n.isDone||n.continueCursor===null?{nextCursor:void 0,status:"Exhausted"}:{nextCursor:n.continueCursor,status:"CanLoadMore"}:{nextCursor:void 0,status:"LoadingMore"}},I=(e,r,n)=>{if(r==null)return;const t=[...e],o=t.at(-1);return o&&(t[t.length-1]={lower:o.lower,numItems:o.numItems,upper:r}),t.push({lower:r,numItems:n,upper:null}),t};export{m as JOIN_FACTOR,l as SPLIT_FACTOR,I as applyLoadMore,a as derivePaginationStatus,p as initialPages,c as rebalance};

package/dist/query/index.d.mts

@@ -1,26 +1,38 @@
-import { S as SubscriptionError, F as FunctionReference, A as ArgsOf, R as ReturnOf, L as LunoraClient, a as Unsubscribe } from "../packem_shared/lunora-client.d-DzEWBYeP.mjs";
-export type { b as SubscriptionErrorCallback } from "../packem_shared/lunora-client.d-DzEWBYeP.mjs";
+import { S as SubscriptionError, L as LunoraClient } from "../packem_shared/lunora-client.d-CEJvJAXn.mjs";
+export type {
+/**
+ * `@lunora/client/query` — the framework-neutral live-query state machine shared
+ * by every Lunora UI adapter (React, Vue, Svelte, Solid). It owns the seam
+ * between a `LunoraClient` subscription and a framework's reactivity primitive:
+ * the subscribe → snapshot → error/reset → cleanup lifecycle, with the
+ * skip-handling, value/error fan-out, attach-throw normalisation, and
+ * cancellation-guarded teardown all in one place. Nothing here imports a UI
+ * framework — each adapter supplies thin sinks that write into its own ref /
+ * store / signal / cache.
+ */
+a as SubscriptionErrorCallback } from "../packem_shared/lunora-client.d-CEJvJAXn.mjs";
+import { F as FunctionReference, A as ArgsOf, R as ReturnOf, a as Unsubscribe } from "../packem_shared/types.d-BOB755CV.mjs";
 import '@lunora/runtime';
 /**
-* The sentinel a framework adapter resolves its reactive args to when it wants
-* to short-circuit a query — no network call, no socket.
-*/
+ * The sentinel a framework adapter resolves its reactive args to when it wants
+ * to short-circuit a query — no network call, no socket.
+ */
 declare const SKIP: "skip";
 /** Args after a framework has resolved its reactivity primitive, or the skip sentinel. */
 type ResolvedArgs<F extends FunctionReference> = ArgsOf<F> | typeof SKIP;
 /**
-* The framework-neutral sinks a {@link createQuerySubscription} call drives. A
-* framework adapter supplies these, wiring each into its own reactivity
-* primitive (a TanStack cache write, a Vue `ref`, a Svelte store `set`, a Solid
-* signal setter).
-*
-* `onData` fires when a fresh server value lands (the initial frame or a delta).
-* `onError` fires when the subscription attach threw, or the server pushed a
-* subscription-scoped error — it is optional, and when omitted an attach throw
-* propagates to the caller (preserving the "no error channel" behaviour of
-* adapters like Solid/Vue that never had one) rather than being swallowed.
-* `onReset` fires when the resolved args are `"skip"`: clear any prior value.
-*/
+ * The framework-neutral sinks a {@link createQuerySubscription} call drives. A
+ * framework adapter supplies these, wiring each into its own reactivity
+ * primitive (a TanStack cache write, a Vue `ref`, a Svelte store `set`, a Solid
+ * signal setter).
+ *
+ * `onData` fires when a fresh server value lands (the initial frame or a delta).
+ * `onError` fires when the subscription attach threw, or the server pushed a
+ * subscription-scoped error — it is optional, and when omitted an attach throw
+ * propagates to the caller (preserving the "no error channel" behaviour of
+ * adapters like Solid/Vue that never had one) rather than being swallowed.
+ * `onReset` fires when the resolved args are `"skip"`: clear any prior value.
+ */
 interface QuerySubscriptionSinks<T> {
   onData: (value: T) => void;
   onError?: (error: SubscriptionError) => void;
@@ -33,30 +45,85 @@ interface QuerySubscriptionOptions {
 /** Normalise an unknown thrown value into the client's {@link SubscriptionError} shape. */
 declare const toSubscriptionError: (error: unknown) => SubscriptionError;
 /**
-* The subscribe → snapshot → error/reset → cleanup state machine shared by
-* every Lunora framework adapter's live-query hook.
-*
-* Given a `client`, a function reference, the already-resolved `args` (a
-* framework reads its own reactive source first, then hands the plain value in),
-* and a set of {@link QuerySubscriptionSinks}, this opens one `client.subscribe`
-* registration and returns the {@link Unsubscribe} to tear it down. Each
-* framework owns *when* to call this (a React effect, a Vue `watch`, a Svelte
-* store start callback, a Solid `createEffect(on(...))`) and *where* to stash
-* the value — this owns the lifecycle in between, so the skip-handling, the
-* value/error fan-out, the attach-throw normalisation, and the
-* cancellation-guarded teardown live in exactly one place.
-*
-* Behaviour. When `args === "skip"` it calls `sinks.onReset?.()` and returns a
-* no-op teardown; no `client.subscribe` is issued. Otherwise it opens
-* `client.subscribe(fn, args, …, { shardKey, onError })`: server pushes route to
-* `sinks.onData`, and the client's own `onError` channel (a server-rejected
-* subscription) routes to `sinks.onError` when present. The attach is wrapped —
-* if `client.subscribe` itself throws, the error is normalised to a
-* {@link SubscriptionError} and delivered to `sinks.onError` when present; with
-* no `onError` sink the throw is rethrown so adapters without an error channel
-* behave exactly as before. The returned teardown is idempotent and
-* cancellation-guarded: once it runs, no further `onData`/`onError` from an
-* in-flight push reaches the sinks.
-*/
+ * The subscribe → snapshot → error/reset → cleanup state machine shared by
+ * every Lunora framework adapter's live-query hook.
+ *
+ * Given a `client`, a function reference, the already-resolved `args` (a
+ * framework reads its own reactive source first, then hands the plain value in),
+ * and a set of {@link QuerySubscriptionSinks}, this opens one `client.subscribe`
+ * registration and returns the {@link Unsubscribe} to tear it down. Each
+ * framework owns *when* to call this (a React effect, a Vue `watch`, a Svelte
+ * store start callback, a Solid `createEffect(on(...))`) and *where* to stash
+ * the value — this owns the lifecycle in between, so the skip-handling, the
+ * value/error fan-out, the attach-throw normalisation, and the
+ * cancellation-guarded teardown live in exactly one place.
+ *
+ * Behaviour. When `args === "skip"` it calls `sinks.onReset?.()` and returns a
+ * no-op teardown; no `client.subscribe` is issued. Otherwise it opens
+ * `client.subscribe(fn, args, …, { shardKey, onError })`: server pushes route to
+ * `sinks.onData`, and the client's own `onError` channel (a server-rejected
+ * subscription) routes to `sinks.onError` when present. The attach is wrapped —
+ * if `client.subscribe` itself throws, the error is normalised to a
+ * {@link SubscriptionError} and delivered to `sinks.onError` when present; with
+ * no `onError` sink the throw is rethrown so adapters without an error channel
+ * behave exactly as before. The returned teardown is idempotent and
+ * cancellation-guarded: once it runs, no further `onData`/`onError` from an
+ * in-flight push reaches the sinks.
+ */
 declare const createQuerySubscription: <F extends FunctionReference, T = ReturnOf<F>>(client: LunoraClient, function_: F, args: ResolvedArgs<F>, sinks: QuerySubscriptionSinks<T>, options?: QuerySubscriptionOptions) => Unsubscribe;
-export { type ArgsOf, type FunctionReference, type QuerySubscriptionOptions, type QuerySubscriptionSinks, type ResolvedArgs, type ReturnOf, SKIP, type SubscriptionError, type Unsubscribe, createQuerySubscription, toSubscriptionError };
+export {
+/**
+ * `@lunora/client/query` — the framework-neutral live-query state machine shared
+ * by every Lunora UI adapter (React, Vue, Svelte, Solid). It owns the seam
+ * between a `LunoraClient` subscription and a framework's reactivity primitive:
+ * the subscribe → snapshot → error/reset → cleanup lifecycle, with the
+ * skip-handling, value/error fan-out, attach-throw normalisation, and
+ * cancellation-guarded teardown all in one place. Nothing here imports a UI
+ * framework — each adapter supplies thin sinks that write into its own ref /
+ * store / signal / cache.
+ */
+type ArgsOf,
+/**
+ * `@lunora/client/query` — the framework-neutral live-query state machine shared
+ * by every Lunora UI adapter (React, Vue, Svelte, Solid). It owns the seam
+ * between a `LunoraClient` subscription and a framework's reactivity primitive:
+ * the subscribe → snapshot → error/reset → cleanup lifecycle, with the
+ * skip-handling, value/error fan-out, attach-throw normalisation, and
+ * cancellation-guarded teardown all in one place. Nothing here imports a UI
+ * framework — each adapter supplies thin sinks that write into its own ref /
+ * store / signal / cache.
+ */
+type FunctionReference, type QuerySubscriptionOptions, type QuerySubscriptionSinks, type ResolvedArgs,
+/**
+ * `@lunora/client/query` — the framework-neutral live-query state machine shared
+ * by every Lunora UI adapter (React, Vue, Svelte, Solid). It owns the seam
+ * between a `LunoraClient` subscription and a framework's reactivity primitive:
+ * the subscribe → snapshot → error/reset → cleanup lifecycle, with the
+ * skip-handling, value/error fan-out, attach-throw normalisation, and
+ * cancellation-guarded teardown all in one place. Nothing here imports a UI
+ * framework — each adapter supplies thin sinks that write into its own ref /
+ * store / signal / cache.
+ */
+type ReturnOf, SKIP,
+/**
+ * `@lunora/client/query` — the framework-neutral live-query state machine shared
+ * by every Lunora UI adapter (React, Vue, Svelte, Solid). It owns the seam
+ * between a `LunoraClient` subscription and a framework's reactivity primitive:
+ * the subscribe → snapshot → error/reset → cleanup lifecycle, with the
+ * skip-handling, value/error fan-out, attach-throw normalisation, and
+ * cancellation-guarded teardown all in one place. Nothing here imports a UI
+ * framework — each adapter supplies thin sinks that write into its own ref /
+ * store / signal / cache.
+ */
+type SubscriptionError,
+/**
+ * `@lunora/client/query` — the framework-neutral live-query state machine shared
+ * by every Lunora UI adapter (React, Vue, Svelte, Solid). It owns the seam
+ * between a `LunoraClient` subscription and a framework's reactivity primitive:
+ * the subscribe → snapshot → error/reset → cleanup lifecycle, with the
+ * skip-handling, value/error fan-out, attach-throw normalisation, and
+ * cancellation-guarded teardown all in one place. Nothing here imports a UI
+ * framework — each adapter supplies thin sinks that write into its own ref /
+ * store / signal / cache.
+ */
+type Unsubscribe, createQuerySubscription, toSubscriptionError };