Merge branch 'main' into davidkpiano/enqueue-all-the-things

.changeset/four-countries-serve.md

@@ -0,0 +1,6 @@
+---
+'@xstate/react': patch
+'@xstate/store': patch
+---
+
+Add React 19 as a peer dependency

.git-blame-ignore-revs

@@ -2,3 +2,7 @@
 71183da18ae6b0b6b2e8f0c52ea9976232e54f41
 94037fe9c429839f0508ddcd287718b659276e3b
 f51bf4d8907307ace083a0decb34668176c7fad3
+
+# lint fixes
+8bff3b8ad57516e9816278b77ff5e0fffafd85ca
+aeec38a6ef56bb534ff8bc968b95107ff54959cc

.github/actions/ci-checks/action.yml

@@ -3,17 +3,25 @@ runs:
   using: 'composite'
   steps:
     - name: Build
-      run: yarn build
+      run: pnpm build
+      shell: bash
+
+    - name: ESLint
+      run: pnpm lint --no-cache
       shell: bash
 
     - name: Typecheck
-      run: yarn typecheck
+      run: pnpm typecheck
       shell: bash
 
     - name: Test
-      run: yarn test --silent
+      run: pnpm test --silent
       shell: bash
 
     - name: Svelte Check
-      run: yarn --cwd packages/xstate-svelte svelte-check
+      run: pnpm --filter @xstate/svelte svelte-check
+      shell: bash
+
+    - name: Knip
+      run: pnpm knip
       shell: bash

.github/actions/ci-setup/action.yml

@@ -2,11 +2,16 @@ name: 'CI setup'
 runs:
   using: 'composite'
   steps:
+    - name: Install pnpm
+      uses: pnpm/action-setup@v4
+
     - name: Use Node.js 20.x
       uses: actions/setup-node@v4
       with:
         node-version: 20.x
+        cache: 'pnpm'
+        registry-url: 'https://registry.npmjs.org'
 
     - name: Install Dependencies
-      run: yarn
+      run: pnpm install
       shell: bash

.github/workflows/docs.yml

@@ -15,16 +15,12 @@ jobs:
 
     steps:
       - uses: actions/checkout@v4
-
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 20.x
+      - uses: ./.github/actions/ci-setup
 
       - name: Build docs
         working-directory: docs
         run: |
-          yarn install
-          yarn docs:build
+          NODE_OPTIONS='--openssl-legacy-provider' pnpm docs:build
 
       - name: Publish docs
         uses: JamesIves/github-pages-deploy-action@4.1.0

.github/workflows/release.yml

@@ -9,6 +9,7 @@ on:
 concurrency: ${{ github.workflow }}-${{ github.ref }}
 
 permissions: {}
+
 jobs:
   release:
     permissions:
@@ -30,8 +31,8 @@ jobs:
       - name: Create Release Pull Request or Publish to npm
         uses: changesets/action@v1
         with:
-          publish: yarn run release
-          version: yarn run version
+          publish: pnpm run release
+          version: pnpm run version
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.gitignore

@@ -1,3 +1,6 @@
+# eslint
+.eslintcache
+
 # Logs
 logs
 *.log

.knip.jsonc

@@ -5,6 +5,21 @@
       "entry": ["scripts/*.js"],
       "project": ["scripts/*.js"]
     },
+    "packages/core": {
+      "entry": [
+        "src/index.ts",
+        "src/actions.ts",
+        "src/actors/index.ts",
+        "src/guards.ts",
+        "src/dev/index.ts"
+      ]
+    },
+    "packages/xstate-inspect": {
+      "entry": ["src/index.ts", "src/server.ts"]
+    },
+    "packages/xstate-store": {
+      "entry": ["src/index.ts", "src/react.ts", "src/solid.ts"]
+    },
     "packages/xstate-svelte": {
       "typescript": "test/tsconfig.json"
     }
@@ -17,11 +32,11 @@
   ],
   "ignoreBinaries": ["svelte-check", "docs:build"],
   "ignoreDependencies": [
-    "@xstate-repo/jest-utils",
     "@xstate-repo/jest-utils/setup",
     "synckit",
     // package.json#exports aren't added as entry points, because `dist/` is .gitignored
     "react",
+    "solid-js",
     "xstate",
     "@types/ws"
   ]

.vscode/launch.json

@@ -5,6 +5,7 @@
       "type": "node",
       "request": "launch",
       "name": "Jest Current File",
+      "runtimeExecutable": "sh",
       "program": "${workspaceFolder}/node_modules/.bin/jest",
       "args": ["${file}", "--config", "jest.config.js", "--no-cache"],
       "console": "integratedTerminal",
@@ -17,6 +18,7 @@
       "type": "node",
       "request": "launch",
       "name": "Jest Current File (no timeout)",
+      "runtimeExecutable": "sh",
       "program": "${workspaceFolder}/node_modules/.bin/jest",
       "args": [
         "${file}",

CONTRIBUTING.md

@@ -15,7 +15,7 @@ Please read [our code of conduct](https://github.com/statelyai/xstate/blob/main/
 ## Environment
 
 - Ensure you have the latest version of Node and Yarn.
-- Run `yarn` to install all needed dev dependencies.
+- Run `pnpm i` to install all needed dev dependencies.
 
 ## Making changes
 
@@ -24,9 +24,9 @@ Pull requests are encouraged. If you want to add a feature or fix a bug:
 1. [Fork](https://docs.github.com/en/github/getting-started-with-github/fork-a-repo) and [clone](https://docs.github.com/en/github/creating-cloning-and-archiving-repositories/cloning-a-repository) the [repository](https://github.com/statelyai/xstate).
 1. [Create a separate branch](https://docs.github.com/en/desktop/contributing-and-collaborating-using-github-desktop/managing-branches) for your changes.
 1. Make your changes, and write tests that validate your change and/or fix.
-1. Run `yarn test` (for all packages) or `yarn test:core` (for only changes to core XState).
-1. Run `yarn typecheck` to make sure that there are no type errors.
-1. Create a changeset by running `yarn changeset`. [More about changesets](https://github.com/atlassian/changesets).
+1. Run `pnpm test` (for all packages) or `pnpm test:core` (for only changes to core XState).
+1. Run `pnpm typecheck` to make sure that there are no type errors.
+1. Create a changeset by running `pnpm changeset`. [More about changesets](https://github.com/atlassian/changesets).
 1. Push your branch and open a PR 🚀
 
 PRs are reviewed promptly and merged in within a day or two (or even within an hour) if everything looks good.
@@ -61,7 +61,7 @@ The [xstate.js.org](https://xstate.js.org) landing page is currently stored at `
 
 ### Building
 
-We are using [preconstruct](https://preconstruct.tools/) to build our packages. It comes with a handy trick which allows us to always use source files of packages contained in this monorepo. It creates hook/redirecting files in place of dist files during development. This always happens after installing packages (during `postinstall` step) and you shouldn't be worried about it, but if you actually build packages you destroy those redirecting files and to run tests, typechecking etc correctly you need to bring them back by running `yarn postinstall`.
+We are using [preconstruct](https://preconstruct.tools/) to build our packages. It comes with a handy trick which allows us to always use source files of packages contained in this monorepo. It creates hook/redirecting files in place of dist files during development. This always happens after installing packages (during `postinstall` step) and you shouldn't be worried about it, but if you actually build packages you destroy those redirecting files and to run tests, typechecking etc correctly you need to bring them back by running `pnpm postinstall`.
 
 ### Publishing
 

README.md

@@ -181,15 +181,16 @@ Read [📽 the slides](http://slides.com/davidkhourshid/finite-state-machines) (
 
 ## Packages
 
-| Package                                                                                       | Description                                                                  |
-| --------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
-| 🤖 `xstate`                                                                                   | Core finite state machine and statecharts library + interpreter              |
-| [📉 `@xstate/graph`](https://github.com/statelyai/xstate/tree/main/packages/xstate-graph)     | Graph traversal and model-based testing utilities using XState               |
-| [⚛️ `@xstate/react`](https://github.com/statelyai/xstate/tree/main/packages/xstate-react)     | React hooks and utilities for using XState in React applications             |
-| [💚 `@xstate/vue`](https://github.com/statelyai/xstate/tree/main/packages/xstate-vue)         | Vue composition functions and utilities for using XState in Vue applications |
-| [🎷 `@xstate/svelte`](https://github.com/statelyai/xstate/tree/main/packages/xstate-svelte)   | Svelte utilities for using XState in Svelte applications                     |
-| [🥏 `@xstate/solid`](https://github.com/statelyai/xstate/tree/main/packages/xstate-solid)     | Solid hooks and utilities for using XState in Solid applications             |
-| [🔍 `@statelyai/inspect`](https://github.com/statelyai/inspect) | Inspection utilities for XState                                              |
+| Package                                                                                     | Description                                                                  |
+| ------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
+| 🤖 `xstate`                                                                                 | Core finite state machine and statecharts library + interpreter              |
+| [📉 `@xstate/graph`](https://github.com/statelyai/xstate/tree/main/packages/xstate-graph)   | Graph traversal and model-based testing utilities using XState               |
+| [⚛️ `@xstate/react`](https://github.com/statelyai/xstate/tree/main/packages/xstate-react)   | React hooks and utilities for using XState in React applications             |
+| [💚 `@xstate/vue`](https://github.com/statelyai/xstate/tree/main/packages/xstate-vue)       | Vue composition functions and utilities for using XState in Vue applications |
+| [🎷 `@xstate/svelte`](https://github.com/statelyai/xstate/tree/main/packages/xstate-svelte) | Svelte utilities for using XState in Svelte applications                     |
+| [🥏 `@xstate/solid`](https://github.com/statelyai/xstate/tree/main/packages/xstate-solid)   | Solid hooks and utilities for using XState in Solid applications             |
+| [🔍 `@statelyai/inspect`](https://github.com/statelyai/inspect)                             | Inspection utilities for XState                                              |
+| [🏪 `@xstate/store`](https://github.com/statelyai/xstate/tree/main/packages/xstate-store)   | Small library for simple state management                                    |
 
 ## Finite State Machines
 

babel.config.js

@@ -1,6 +1,3 @@
-const { NODE_ENV } = process.env;
-const isTest = NODE_ENV === 'test';
-
 module.exports = {
   assumptions: {
     constantReexports: true, // only matters for tests (since only there we transpile to CJS using Babel), it makes debugging easier

docs/fr/sandboxes/todomvc/package.json

@@ -18,6 +18,6 @@
     "xstate",
     "react"
   ],
-  "name": "xstate-todomvc",
+  "name": "xstate-todomvc-fr",
   "description": "The TodoMVC app implemented with React (using hooks) and XState version 4."
 }

docs/package.json

@@ -7,11 +7,11 @@
   "author": "David Khourshid",
   "license": "MIT",
   "scripts": {
-    "docs:dev": "yarn vuepress dev .",
+    "docs:dev": "pnpm vuepress dev .",
     "docs:readme": "cpy ../README.md .",
-    "docs:build": "npm run docs:readme && vuepress build .",
-    "docs:pdf": "npm run docs:build && vuepress export .",
-    "docs:publish": "npm run docs:build && gh-pages --dist .vuepress/dist --dest ./docs"
+    "docs:build": "pnpm run docs:readme && vuepress build .",
+    "docs:pdf": "pnpm run docs:build && vuepress export .",
+    "docs:publish": "pnpm run docs:build && gh-pages --dist .vuepress/dist --dest ./docs"
   },
   "dependencies": {
     "@vuepress/plugin-google-analytics": "^1.8.2",