@syncular/react 0.15.44 → 0.15.45

package/dist/client.d.ts

@@ -5,7 +5,7 @@
  * their public surfaces diverge (getters vs methods, sync vs promise), so
  * this module normalizes both into a single async-friendly facade the hooks
  * consume. That is the "one interface across direct and worker-handle modes"
- * the invalidation seam (TODO 3.1) was standardized to enable.
+ * the invalidation seam enables.
  *
  * The normalizer resolves each accessor at call time (function → call it,
  * value → read it) and wraps every result in `Promise.resolve`, so a hook

package/dist/client.js

@@ -5,7 +5,7 @@
  * their public surfaces diverge (getters vs methods, sync vs promise), so
  * this module normalizes both into a single async-friendly facade the hooks
  * consume. That is the "one interface across direct and worker-handle modes"
- * the invalidation seam (TODO 3.1) was standardized to enable.
+ * the invalidation seam enables.
  *
  * The normalizer resolves each accessor at call time (function → call it,
  * value → read it) and wraps every result in `Promise.resolve`, so a hook

package/dist/index.d.ts

@@ -1,13 +1,13 @@
 /**
  * @syncular/react — React bindings with fine-grained live queries
- * (TODO 3.1 / DESIGN-eviction I1–I4). Works against BOTH `SyncClient`
+ * Works against BOTH `SyncClient`
  * (direct) and `SyncClientHandle` (worker) through one normalized client
  * interface. React 18+ (react is a peer dependency); no other runtime deps.
  *
  * See README.md for the invalidation granularity truth and the `tables`
  * option.
  */
-export type { NormalizedClient, SyncClientLike, } from './client.js';
+export type { NormalizedClient, SyncClientLike } from './client.js';
 export { normalizeClient } from './client.js';
 export { inferTables } from './infer-tables.js';
 export { type SyncBoundaryActions, type SyncBoundaryState, SyncContext, SyncProvider, type SyncProviderProps, SyncStoreContext, } from './provider.js';
@@ -19,7 +19,7 @@ export { type UseConflictsResult, useConflicts } from './use-conflicts.js';
 export { type UseDiagnosticsOptions, type UseDiagnosticsResult, useDiagnostics, } from './use-diagnostics.js';
 export { type SyncTableDescriptor, type UseMutationOptions, type UseMutationResult, type UseTableMutationResult, useMutation, } from './use-mutation.js';
 export { usePresence } from './use-presence.js';
-export { type NamedQueryDescriptor, useQuery, } from './use-query.js';
+export { type NamedQueryDescriptor, useQuery } from './use-query.js';
 export { type UseRawSqlOptions, type UseRawSqlResult, useRawSql, } from './use-raw-sql.js';
 export { type SyncStatus, useSyncStatus } from './use-sync-status.js';
 export { type UseRetainedWindowResult, type UseWindowResult, useRetainedWindow, useWindow, } from './use-window.js';

package/dist/index.js

@@ -12,7 +12,7 @@ export { useConflicts } from './use-conflicts.js';
 export { useDiagnostics, } from './use-diagnostics.js';
 export { useMutation, } from './use-mutation.js';
 export { usePresence } from './use-presence.js';
-export { useQuery, } from './use-query.js';
+export { useQuery } from './use-query.js';
 export { useRawSql, } from './use-raw-sql.js';
 export { useSyncStatus } from './use-sync-status.js';
 export { useRetainedWindow, useWindow, } from './use-window.js';

package/dist/infer-tables.d.ts

@@ -1,5 +1,5 @@
 /**
- * Conservative table inference for `useRawSql` (TODO 3.1: "infer
+ * Conservative table inference for `useRawSql`: infer
  * conservatively from the SQL text's table names … documented as a
  * heuristic with the explicit option as the escape hatch").
  *

package/dist/infer-tables.js

@@ -1,5 +1,5 @@
 /**
- * Conservative table inference for `useRawSql` (TODO 3.1: "infer
+ * Conservative table inference for `useRawSql`: infer
  * conservatively from the SQL text's table names … documented as a
  * heuristic with the explicit option as the escape hatch").
  *

package/dist/runtime-version.d.ts

@@ -3,4 +3,4 @@
  * Vite HMR uses it to replace a worker owner after a Syncular package upgrade
  * even when the application's generated schema version did not change.
  */
-export declare const SYNCULAR_REACT_RUNTIME_VERSION = "0.15.44";
+export declare const SYNCULAR_REACT_RUNTIME_VERSION = "0.15.45";

package/dist/runtime-version.js

@@ -3,4 +3,4 @@
  * Vite HMR uses it to replace a worker owner after a Syncular package upgrade
  * even when the application's generated schema version did not change.
  */
-export const SYNCULAR_REACT_RUNTIME_VERSION = '0.15.44';
+export const SYNCULAR_REACT_RUNTIME_VERSION = '0.15.45';

package/dist/use-raw-sql.js

@@ -33,7 +33,7 @@ export function useRawSql(sql, params, options) {
     // `identity` canonically contains every value-shaped input. Depending on
     // the caller's array/object references would defeat value-stable query
     // identity; executable decoders and row keys follow function identity.
-    // biome-ignore lint/correctness/useExhaustiveDependencies: canonical value identity is the dependency
+    // oxlint-disable react-hooks/exhaustive-deps -- canonical value identity is the dependency
     const entry = useMemo(() => store.query({
         id: options?.id ?? `raw:${identity}`,
         sql,
@@ -44,6 +44,7 @@ export function useRawSql(sql, params, options) {
         ...(options?.rowKey !== undefined ? { rowKey: options.rowKey } : {}),
         claimCoverage: options?.claimCoverage ?? true,
     }), [store, identity, options?.mapRow, options?.rowKey]);
+    // oxlint-enable react-hooks/exhaustive-deps
     const snapshot = useSyncExternalStore(enabled ? entry.subscribe : noSubscribe, enabled ? entry.getSnapshot : () => DISABLED, enabled ? entry.getSnapshot : () => DISABLED);
     const refresh = useCallback(() => {
         if (enabled)

package/dist/use-window.js

@@ -10,10 +10,11 @@ export function useRetainedWindow(base, units) {
     const store = useReactiveStore();
     const baseIdentity = canonicalValue(base);
     const unitsIdentity = canonicalValue([...new Set(units)].sort());
-    // biome-ignore lint/correctness/useExhaustiveDependencies: canonical identities represent the complete values
+    // oxlint-disable-next-line react-hooks/exhaustive-deps -- canonical identities represent the complete values
     const stableBase = useMemo(() => base, [baseIdentity]);
-    // biome-ignore lint/correctness/useExhaustiveDependencies: unitsIdentity represents the normalized unit set
+    // oxlint-disable react-hooks/exhaustive-deps -- unitsIdentity represents the normalized unit set
     const stableUnits = useMemo(() => [...new Set(units)].sort(), [unitsIdentity]);
+    // oxlint-enable react-hooks/exhaustive-deps
     const [state, setState] = useState({
         isPending: true,
         error: undefined,
@@ -48,7 +49,7 @@ export function useWindow(base) {
     const baseIdentity = canonicalValue(base);
     // Window bases are value objects commonly recreated during render. Preserve
     // the prior object while its canonical value is unchanged.
-    // biome-ignore lint/correctness/useExhaustiveDependencies: baseIdentity represents the complete value
+    // oxlint-disable-next-line react-hooks/exhaustive-deps -- baseIdentity represents the complete value
     const stableBase = useMemo(() => base, [baseIdentity]);
     const entry = useMemo(() => store.window(stableBase), [store, stableBase]);
     const state = useSyncExternalStore(entry.subscribe, entry.getSnapshot, entry.getSnapshot);

package/dist/vite-hmr.js

@@ -11,7 +11,7 @@ function isResource(value) {
 function retainedFrom(hotData) {
     const value = hotData?.syncularClientResource;
     if (isResource(value)) {
-        // Compatibility with the pre-RFC guide, which retained the bare resource.
+        // Compatibility with the older guide, which retained the bare resource.
         return { resource: value };
     }
     if (typeof value !== 'object' || value === null)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syncular/react",
-  "version": "0.15.44",
+  "version": "0.15.45",
   "description": "React hooks for Syncular offline-first sync",
   "license": "Apache-2.0",
   "author": "Benjamin Kniffler",
@@ -55,15 +55,15 @@
     "test": "bun test --preload ./test/setup.ts"
   },
   "dependencies": {
-    "@syncular/client": "0.15.44"
+    "@syncular/client": "0.15.45"
   },
   "peerDependencies": {
     "react": ">=18.0.0"
   },
   "devDependencies": {
     "@happy-dom/global-registrator": "^20.0.0",
-    "@syncular/core": "0.15.44",
-    "@syncular/server": "0.15.44",
+    "@syncular/core": "0.15.45",
+    "@syncular/server": "0.15.45",
     "@testing-library/react": "^16.1.0",
     "@types/react": "^18.3.0",
     "react": "^18.3.1",

package/src/client.ts

@@ -5,7 +5,7 @@
  * their public surfaces diverge (getters vs methods, sync vs promise), so
  * this module normalizes both into a single async-friendly facade the hooks
  * consume. That is the "one interface across direct and worker-handle modes"
- * the invalidation seam (TODO 3.1) was standardized to enable.
+ * the invalidation seam enables.
  *
  * The normalizer resolves each accessor at call time (function → call it,
  * value → read it) and wraps every result in `Promise.resolve`, so a hook

package/src/index.ts

@@ -1,16 +1,13 @@
 /**
  * @syncular/react — React bindings with fine-grained live queries
- * (TODO 3.1 / DESIGN-eviction I1–I4). Works against BOTH `SyncClient`
+ * Works against BOTH `SyncClient`
  * (direct) and `SyncClientHandle` (worker) through one normalized client
  * interface. React 18+ (react is a peer dependency); no other runtime deps.
  *
  * See README.md for the invalidation granularity truth and the `tables`
  * option.
  */
-export type {
-  NormalizedClient,
-  SyncClientLike,
-} from './client';
+export type { NormalizedClient, SyncClientLike } from './client';
 // `normalizeClient` is the runtime facade the hooks consume; exported so
 // alternate hosts (e.g. `@syncular/tauri`) can assert shape-parity against
 // the exact normalizer the bindings use.
@@ -50,10 +47,7 @@ export {
   useMutation,
 } from './use-mutation';
 export { usePresence } from './use-presence';
-export {
-  type NamedQueryDescriptor,
-  useQuery,
-} from './use-query';
+export { type NamedQueryDescriptor, useQuery } from './use-query';
 export {
   type UseRawSqlOptions,
   type UseRawSqlResult,

package/src/infer-tables.ts

@@ -1,5 +1,5 @@
 /**
- * Conservative table inference for `useRawSql` (TODO 3.1: "infer
+ * Conservative table inference for `useRawSql`: infer
  * conservatively from the SQL text's table names … documented as a
  * heuristic with the explicit option as the escape hatch").
  *

package/src/runtime-version.ts

@@ -3,4 +3,4 @@
  * Vite HMR uses it to replace a worker owner after a Syncular package upgrade
  * even when the application's generated schema version did not change.
  */
-export const SYNCULAR_REACT_RUNTIME_VERSION = '0.15.44';
+export const SYNCULAR_REACT_RUNTIME_VERSION = '0.15.45';

package/src/use-mutation.ts

@@ -25,8 +25,11 @@ export interface UseMutationResult {
   readonly resetError: () => void;
 }
 
-export interface UseTableMutationResult<Insert, Update, Id>
-  extends UseMutationResult {
+export interface UseTableMutationResult<
+  Insert,
+  Update,
+  Id,
+> extends UseMutationResult {
   readonly upsert: (values: Insert, baseVersion?: number) => Promise<string>;
   readonly patch: (
     id: Id,

package/src/use-raw-sql.ts

@@ -77,7 +77,7 @@ export function useRawSql<Row = SqlRow>(
   // `identity` canonically contains every value-shaped input. Depending on
   // the caller's array/object references would defeat value-stable query
   // identity; executable decoders and row keys follow function identity.
-  // biome-ignore lint/correctness/useExhaustiveDependencies: canonical value identity is the dependency
+  // oxlint-disable react-hooks/exhaustive-deps -- canonical value identity is the dependency
   const entry = useMemo(
     () =>
       store.query<Row>({
@@ -92,6 +92,7 @@ export function useRawSql<Row = SqlRow>(
       }),
     [store, identity, options?.mapRow, options?.rowKey],
   );
+  // oxlint-enable react-hooks/exhaustive-deps
   const snapshot = useSyncExternalStore(
     enabled ? entry.subscribe : noSubscribe,
     enabled ? entry.getSnapshot : () => DISABLED,

package/src/use-window.ts

@@ -40,13 +40,14 @@ export function useRetainedWindow(
   const store = useReactiveStore();
   const baseIdentity = canonicalValue(base);
   const unitsIdentity = canonicalValue([...new Set(units)].sort());
-  // biome-ignore lint/correctness/useExhaustiveDependencies: canonical identities represent the complete values
+  // oxlint-disable-next-line react-hooks/exhaustive-deps -- canonical identities represent the complete values
   const stableBase = useMemo(() => base, [baseIdentity]);
-  // biome-ignore lint/correctness/useExhaustiveDependencies: unitsIdentity represents the normalized unit set
+  // oxlint-disable react-hooks/exhaustive-deps -- unitsIdentity represents the normalized unit set
   const stableUnits = useMemo(
     () => [...new Set(units)].sort(),
     [unitsIdentity],
   );
+  // oxlint-enable react-hooks/exhaustive-deps
   const [state, setState] = useState<UseRetainedWindowResult>({
     isPending: true,
     error: undefined,
@@ -87,7 +88,7 @@ export function useWindow(base: WindowBase): UseWindowResult {
   const baseIdentity = canonicalValue(base);
   // Window bases are value objects commonly recreated during render. Preserve
   // the prior object while its canonical value is unchanged.
-  // biome-ignore lint/correctness/useExhaustiveDependencies: baseIdentity represents the complete value
+  // oxlint-disable-next-line react-hooks/exhaustive-deps -- baseIdentity represents the complete value
   const stableBase = useMemo(() => base, [baseIdentity]);
   const entry = useMemo(() => store.window(stableBase), [store, stableBase]);
   const state = useSyncExternalStore(

package/src/vite-hmr.ts

@@ -69,7 +69,7 @@ function retainedFrom(hotData: HotData | undefined):
   | undefined {
   const value = hotData?.syncularClientResource;
   if (isResource(value)) {
-    // Compatibility with the pre-RFC guide, which retained the bare resource.
+    // Compatibility with the older guide, which retained the bare resource.
     return { resource: value };
   }
   if (typeof value !== 'object' || value === null) return undefined;