✨ feat: implement mock data support with API interceptor and update documentation

types/global.d.ts

@@ -155,3 +155,6 @@ interface ProductEntry {
     id: string
     // ...
 }
+
+/** Build-time flag: `true` when built with `MOCK=1`, enables API mock interceptor */
+declare const __MOCK__: boolean