@proofhound/web-ui 0.1.11 → 0.1.12

package/dist/hooks/index.d.ts

@@ -15,4 +15,5 @@ export * from './token';
 export * from './use-auto-refresh';
 export * from './use-date-time-formatter';
 export * from './use-delayed-loading';
+export * from './use-mounted';
 //# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC"}

package/dist/hooks/index.js

@@ -15,4 +15,5 @@ export * from './token';
 export * from './use-auto-refresh';
 export * from './use-date-time-formatter';
 export * from './use-delayed-loading';
+export * from './use-mounted';
 //# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC"}

package/dist/hooks/use-mounted.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Returns `false` during the server render and the client's first (hydration) render,
+ * flipping to `true` only after the component has mounted on the client.
+ *
+ * Use it as a hydration boundary for content that depends on client-only state — e.g. a
+ * React Query cache that is never prefetched/dehydrated on the server. Gating such content
+ * behind `useMounted()` guarantees the server output and the client's first paint render the
+ * same placeholder, then the real content appears after mount. Unlike `useDelayedLoading`
+ * (an anti-flicker timer), this establishes a deterministic first frame, so it is the correct
+ * tool for avoiding hydration mismatches.
+ */
+export declare function useMounted(): boolean;
+//# sourceMappingURL=use-mounted.d.ts.map

package/dist/hooks/use-mounted.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-mounted.d.ts","sourceRoot":"","sources":["../../src/hooks/use-mounted.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAOpC"}

package/dist/hooks/use-mounted.js

@@ -0,0 +1,22 @@
+'use client';
+import { useEffect, useState } from 'react';
+/**
+ * Returns `false` during the server render and the client's first (hydration) render,
+ * flipping to `true` only after the component has mounted on the client.
+ *
+ * Use it as a hydration boundary for content that depends on client-only state — e.g. a
+ * React Query cache that is never prefetched/dehydrated on the server. Gating such content
+ * behind `useMounted()` guarantees the server output and the client's first paint render the
+ * same placeholder, then the real content appears after mount. Unlike `useDelayedLoading`
+ * (an anti-flicker timer), this establishes a deterministic first frame, so it is the correct
+ * tool for avoiding hydration mismatches.
+ */
+export function useMounted() {
+    const [mounted, setMounted] = useState(false);
+    useEffect(() => {
+        // eslint-disable-next-line react-hooks/set-state-in-effect -- intentional: the post-mount flip is exactly what makes this a hydration boundary
+        setMounted(true);
+    }, []);
+    return mounted;
+}
+//# sourceMappingURL=use-mounted.js.map

package/dist/hooks/use-mounted.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-mounted.js","sourceRoot":"","sources":["../../src/hooks/use-mounted.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE5C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9C,SAAS,CAAC,GAAG,EAAE;QACb,+IAA+I;QAC/I,UAAU,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC,EAAE,EAAE,CAAC,CAAC;IACP,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/providers/refine-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"refine-provider.d.ts","sourceRoot":"","sources":["../../src/providers/refine-provider.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAYjD,wBAAgB,cAAc,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,2CAiBnE"}
+{"version":3,"file":"refine-provider.d.ts","sourceRoot":"","sources":["../../src/providers/refine-provider.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AA8BjD,wBAAgB,cAAc,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,2CAkBnE"}

package/dist/providers/refine-provider.js

@@ -4,16 +4,33 @@ import { Refine } from '@refinedev/core';
 import routerProvider from '@refinedev/nextjs-router';
 import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
 import { Suspense } from 'react';
-const queryClient = new QueryClient({
-    defaultOptions: {
-        queries: {
-            retry: 1,
-            staleTime: 30_000,
-            refetchOnWindowFocus: true,
+function makeQueryClient() {
+    return new QueryClient({
+        defaultOptions: {
+            queries: {
+                retry: 1,
+                staleTime: 30_000,
+                refetchOnWindowFocus: true,
+            },
         },
-    },
-});
+    });
+}
+let browserQueryClient;
+// TanStack's recommended SSR pattern: a fresh client per request on the server (so the cache
+// never leaks across requests and every SSR starts from an empty cache for a deterministic
+// first paint), and a reused singleton in the browser (so the cache survives Suspense, remounts
+// and client-side navigations). The previous module-level singleton was shared across all
+// server requests, which is both a cross-request data-leak hazard and a source of hydration
+// mismatches (a warm server cache could render content the client's fresh first paint lacked).
+function getQueryClient() {
+    if (typeof window === 'undefined') {
+        return makeQueryClient();
+    }
+    browserQueryClient ??= makeQueryClient();
+    return browserQueryClient;
+}
 export function RefineProvider({ children }) {
+    const queryClient = getQueryClient();
     return (_jsx(QueryClientProvider, { client: queryClient, children: _jsx(Suspense, { fallback: null, children: _jsx(Refine, { routerProvider: routerProvider, options: {
                     syncWithLocation: true,
                     warnWhenUnsavedChanges: false,

package/dist/providers/refine-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"refine-provider.js","sourceRoot":"","sources":["../../src/providers/refine-provider.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,cAAc,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAkB,MAAM,OAAO,CAAC;AAEjD,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC;IAClC,cAAc,EAAE;QACd,OAAO,EAAE;YACP,KAAK,EAAE,CAAC;YACR,SAAS,EAAE,MAAM;YACjB,oBAAoB,EAAE,IAAI;SAC3B;KACF;CACF,CAAC,CAAC;AAEH,MAAM,UAAU,cAAc,CAAC,EAAE,QAAQ,EAA2B;IAClE,OAAO,CACL,KAAC,mBAAmB,IAAC,MAAM,EAAE,WAAW,YACtC,KAAC,QAAQ,IAAC,QAAQ,EAAE,IAAI,YACtB,KAAC,MAAM,IACL,cAAc,EAAE,cAAc,EAC9B,OAAO,EAAE;oBACP,gBAAgB,EAAE,IAAI;oBACtB,sBAAsB,EAAE,KAAK;oBAC7B,gBAAgB,EAAE,IAAI;iBACvB,YAEA,QAAQ,GACF,GACA,GACS,CACvB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"refine-provider.js","sourceRoot":"","sources":["../../src/providers/refine-provider.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,cAAc,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAkB,MAAM,OAAO,CAAC;AAEjD,SAAS,eAAe;IACtB,OAAO,IAAI,WAAW,CAAC;QACrB,cAAc,EAAE;YACd,OAAO,EAAE;gBACP,KAAK,EAAE,CAAC;gBACR,SAAS,EAAE,MAAM;gBACjB,oBAAoB,EAAE,IAAI;aAC3B;SACF;KACF,CAAC,CAAC;AACL,CAAC;AAED,IAAI,kBAA2C,CAAC;AAEhD,6FAA6F;AAC7F,2FAA2F;AAC3F,gGAAgG;AAChG,0FAA0F;AAC1F,4FAA4F;AAC5F,+FAA+F;AAC/F,SAAS,cAAc;IACrB,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,OAAO,eAAe,EAAE,CAAC;IAC3B,CAAC;IACD,kBAAkB,KAAK,eAAe,EAAE,CAAC;IACzC,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,EAAE,QAAQ,EAA2B;IAClE,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IACrC,OAAO,CACL,KAAC,mBAAmB,IAAC,MAAM,EAAE,WAAW,YACtC,KAAC,QAAQ,IAAC,QAAQ,EAAE,IAAI,YACtB,KAAC,MAAM,IACL,cAAc,EAAE,cAAc,EAC9B,OAAO,EAAE;oBACP,gBAAgB,EAAE,IAAI;oBACtB,sBAAsB,EAAE,KAAK;oBAC7B,gBAAgB,EAAE,IAAI;iBACvB,YAEA,QAAQ,GACF,GACA,GACS,CACvB,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proofhound/web-ui",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "description": "ProofHound reusable product frontend: screens / hooks / providers / i18n / components / contracts",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -30,9 +30,9 @@
     "jsonc-parser": "3.3.1",
     "lucide-react": "^1.14.0",
     "recharts": "^3.3.1",
-    "@proofhound/ui": "0.1.11",
-    "@proofhound/api-client": "0.1.11",
-    "@proofhound/shared": "0.1.11"
+    "@proofhound/ui": "0.1.12",
+    "@proofhound/api-client": "0.1.12",
+    "@proofhound/shared": "0.1.12"
   },
   "peerDependencies": {
     "next": "^16",