createFormStore-workspace

Co-authored-by: antoniopangallo <a.pangallo85@gmail.com>

Author: iusehooks

.github/workflows/github-actions.yml

@@ -11,7 +11,7 @@ on:
         default: "false"
 
 env:
-  NODE_VERSION: 18.20.8
+  NODE_VERSION: 20.19.0
 
 jobs:
   tests:
@@ -79,6 +79,9 @@ jobs:
   cypress-test:
     name: Automation Tests 🌐
     runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        browser: [chrome, firefox, edge, electron]
     env:
       TERM: xterm
       CI: true
@@ -102,18 +105,19 @@ jobs:
       - name: Wait for server ⏳
         run: npx wait-on http://localhost:3000/index_react_16.13.0.html --timeout 120000
 
-      - name: Run Cypress Tests 🧪
+      - name: Run Cypress Tests on ${{ matrix.browser }} 🧪
         uses: cypress-io/github-action@v6
         env:
           CI: true
         with:
-          command: yarn cy:run
+          browser: ${{ matrix.browser }}
+          command: yarn cy:run --browser ${{ matrix.browser }}
 
       - name: Upload Cypress Artifacts 📂
         if: always()
         uses: actions/upload-artifact@v4
         with:
-          name: cypress-artifacts-${{ github.run_number }}-${{ github.sha }}
+          name: cypress-artifacts-${{ matrix.browser }}-${{ github.run_number }}-${{ github.sha }}
           path: |
             cypress/videos
             cypress/screenshots
@@ -205,6 +209,7 @@ jobs:
       - name: Extract current version
         id: version
         run: echo "VERSION=$(node -p "require('./package.json').version")" >> $GITHUB_ENV
+        working-directory: workspaces/usetheform
 
       - name: 🏷️ Check if tag already exists
         run: |

.nvmrc

@@ -1 +1 @@
-v18.20.8
+v20.19.0

.prettierignore

@@ -1 +1,2 @@
 *.mdx
+cypress/server/lib

CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## [v4.0.0](https://github.com/iusehooks/usetheform/releases/tag/v4.0.0)
+
+### Improvements:
+
+- Added `createFormStore`: create and manage reactive form state with a store and selector hook — no provider needed.
+
+Need to read or manipulate Form's Fields anywhere outside Form context?
+
+**Example:**
+
+```javascript
+import { createFormStore } from 'usetheform';
+
+const [formStore, useFormSelector] = createFormStore({ counter: 0 });
+
+export const awesomeFormStore = formStore;
+export const useAwesomeFormSelector = useFormSelector;
+```
+
+### Fixes:
+
+- Fixed issues with React 18+ strict mode in certain edge cases when using the `<Collection array />`
+
 ## [v3.6.0](https://github.com/iusehooks/usetheform/releases/tag/v3.6.0)
 
 ### Improvements:

CONTRIBUTING.md

@@ -1,43 +1,86 @@
 # Contributing to UseTheForm
 
-🎉 First off, thanks for taking the time to contribute! 🎉
+🎉 First off, **thank you** for taking the time to contribute — your help is what keeps this project growing! 🎉
 
-With the aim of ensuring that `usetheform` lives and continues to grow we would like to encourage everyone to help and support this library by contributing.
+We welcome all contributions, whether you're fixing bugs, adding new features, improving documentation, or simply spreading the word. Let's build something great together.
 
-## Pull Request Process
+## Prerequisites
 
-1. Fork and clone the repo to your local machine
+Before getting started, make sure you have the following tools installed:
 
-2. Create a new branch from `master` with a meaningful name for a new feature or an issue you want to work on: `git checkout -b your-meaningful-branch-name`
+- **Node.js** (v20.19.0 is recommended)
+  Make sure you have Node.js installed. You can manage multiple versions of Node.js using [nvm](https://github.com/nvm-sh/nvm).
 
-3. Install packages by running:
+- **Corepack** (which comes bundled with Node.js v16.9 and later)
+  Corepack allows you to manage Yarn versions per project without requiring a global installation of Yarn.
 
-	> npm i
-	
-4. If you have added/removed code ensure that test suite still passes.
+## 🚀 Getting Started
 
-	> npm test
-	
-5. Write some unit tests to cover as much of your code as possible.
+1. **Fork** the repository and **clone** it to your local machine:
+   ```bash
+   git clone https://github.com/your-username/usetheform.git
+   ```
 
-6. Ensure your code lints without errors.
+2. **Enable Yarn via Corepack** (required for newer versions of Node.js):
 
-	> npm run lint
-	
-7. Ensure build passes.
+   If you don’t have Yarn installed globally, just enable it with:
+   ```bash
+   corepack enable
+   ```
 
-	> npm run build
-	
-8. Push your branch: `git push -u origin your-meaningful-branch-name`
+   > 💡 `corepack` comes bundled with Node.js (v16.10+), and helps manage Yarn versions.
 
-9. Submit a pull request to the upstream usetheform repository.
+3. **Install dependencies**:
+   ```bash
+   yarn
+   ```
 
-10. Choose a descriptive title and describe your changes briefly.
+4. **Create a new branch** from `master` with a meaningful name:
+   ```bash
+   git checkout -b your-feature-or-fix-name
+   ```
 
-## Coding style
+## ✅ Development Checklist
 
-UseTheForm uses eslint and prettier. As suggestion, you might enable the eslint and prettier plugins in your editor to get real-time feedback. To execute the linting manually, run the following command: `npm run lint`
+Before submitting your pull request, please make sure to:
 
-## License
+- ✅ **Run tests** to ensure everything works as expected:
+  ```bash
+  yarn test
+  ```
 
-By contributing your code to the usetheform GitHub repository, you agree to license your code under the MIT license.
+- ✅ **Write unit tests** for your changes where applicable.
+
+- ✅ **Lint your code** for formatting and style issues:
+  ```bash
+  yarn lint
+  ```
+
+- ✅ **Build the project** to verify that everything compiles:
+  ```bash
+  yarn build
+  ```
+
+- ✅ **Push your branch** to your forked repo:
+  ```bash
+  git push -u origin your-feature-or-fix-name
+  ```
+
+- ✅ **Open a Pull Request** against the `master` branch in the main repository.
+  - Use a **clear title** and **brief description** of your changes.
+
+## 🧑‍💻 Code Style
+
+UseTheForm follows consistent styling via **ESLint** and **Prettier**.
+
+👉 We recommend enabling their plugins in your code editor for real-time feedback.
+
+Run manually:
+
+```bash
+yarn lint
+```
+
+## 📄 License
+
+By contributing to this project, you agree to license your work under the [MIT License](../LICENSE.md), in line with the rest of the repository.