feat: added functions for starting and stopping polling

closes #17

Author: TimMikeladze

README.md

@@ -1,6 +1,6 @@
 # 🗂️ use-fs
 
-A React hook for integrating with the [File System Access API](https://developer.mozilla.org/en-US/docs/Web/API/File_System_Access_API). Visit [**use-fs.com**](https://use-fs.com) to try it out.
+A React hook for integrating with the [File System Access API](https://developer.mozilla.org/en-US/docs/Web/API/File_System_Access_API). Visit [**use-fs.com**](https://use-fs.com) to try it out in your browser.
 
 The File System Access API enables web applications to seamlessly work with files on a user's local system. After a user grants permission, web apps can read, write, and manage files directly - eliminating the need for repeated file selection dialogs. This capability is ideal for creating powerful browser-based tools.
 
@@ -33,7 +33,10 @@ function App() {
     onClear,
     isProcessing,
     writeFile,
-    deleteFile
+    deleteFile,
+    startPolling,
+    stopPolling,
+    isPolling
   } = useFs({
     // Optional array of filter functions to exclude files/directories. By default `commonFilters` is used to ignore .git, node_modules, etc.
     filters: [
@@ -104,6 +107,24 @@ function App() {
         Clear
       </button>
 
+      <button 
+        onClick={startPolling}
+        disabled={isProcessing || isPolling}
+      >
+        Start Polling
+      </button>
+
+      <button 
+        onClick={stopPolling}
+        disabled={isProcessing || !isPolling}
+      >
+        Stop Polling
+      </button>
+
+      <div>
+        Status: {isPolling ? 'Polling Active' : 'Polling Stopped'}
+      </div>
+
       {files.size > 0 && (
         <div>
           <h2>Files ({files.size}):</h2>
@@ -133,10 +154,11 @@ The hook provides several key features:
 1. **File System Access**: Prompts users to select a directory and maintains access to it.
 2. **File Writing**: Allows writing content to files with options for truncation and creation.
 3. **File Deletion**: Enables safe removal of files from the selected directory.
-4. **File Watching**: Continuously monitors selected directory for changes.
-5. **Content Management**: Provides access to file contents and updates in real-time.
-6. **Filtering**: Built-in and custom filters to exclude unwanted files/directories.
-7. **Performance Optimizations**: 
+4. **File Watching**: Continuously monitors selected directory for changes with automatic polling.
+5. **Polling Control**: Manual control over when to start/stop monitoring for file changes.
+6. **Content Management**: Provides access to file contents and updates in real-time.
+7. **Filtering**: Built-in and custom filters to exclude unwanted files/directories.
+8. **Performance Optimizations**: 
    - Batched file processing
    - Content caching
    - Debounced updates
@@ -161,4 +183,18 @@ The hook provides several key features:
 - `isProcessing: boolean` - Whether files are being processed
 - `isBrowserSupported: boolean` - Whether File System API is supported
 - `writeFile: (path: string, data: string | ArrayBuffer | Blob, options?: FileWriteOptions) => Promise<void>` - Function to write to files
-- `deleteFile: (path: string) => Promise<void>` - Function to delete files
+- `deleteFile: (path: string) => Promise<void>` - Function to delete files
+- `startPolling: () => void` - Function to manually start polling for file changes
+- `stopPolling: () => void` - Function to manually stop polling for file changes  
+- `isPolling: boolean` - Whether the hook is actively polling for changes
+
+
+## 📚 Contributing
+
+1. Navigate to the `docs` directory
+2. Run `pnpm install` to install the dependencies
+3. Run `pnpm dev` to start the development server
+3. Navigate to `http://localhost:3000` to view the demo.
+5. Modify the `Demo.tsx` file to make your changes.
+
+If you're making changes to the `use-fs` package, you can run `pnpm build` to build the package and then run `pnpm link use-fs` to link the package to the `docs` directory for local development and testing.

docs/README.md

@@ -1,13 +1,4 @@
 ---
-title: Hello World
-description: Your first document
+title: use-fs
+description: A React hook for integrating with the File System Access API.
 ---
-
-Welcome to the docs! You can start writing documents in `/content/docs`.
-
-## What is Next?
-
-<Cards>
-  <Card title="Learn more about Next.js" href="https://nextjs.org/docs" />
-  <Card title="Learn more about Fumadocs" href="https://fumadocs.vercel.app" />
-</Cards>

docs/content/docs/index.mdx

@@ -17,7 +17,7 @@
 		"react": "^19.0.0",
 		"react-dom": "^19.0.0",
 		"react-install-command": "^1.1.2",
-		"use-fs": "^0.0.12"
+		"use-fs": "0.0.12"
 	},
 	"devDependencies": {
 		"@iconify/react": "^5.2.0",