@typeonce/effect-machine-react 0.28.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sandro Maglione
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE

@@ -0,0 +1,3 @@
+Portions are adapted from the Effect project, which is distributed under the
+MIT License. See https://github.com/Effect-TS/effect and the source history for
+authorship and provenance.

package/README.md

@@ -0,0 +1,26 @@
+# @typeonce/effect-machine-react
+
+React ownership hooks for machine atoms created by
+[`@typeonce/effect-machine`](../effect-machine/README.md).
+
+```tsx
+import { useMachineAtom } from "@typeonce/effect-machine-react"
+
+function AuthProvider({ input, children }: Props) {
+  const machine = useMachineAtom(() => MachineAtoms.make(AuthMachine, input))
+
+  return (
+    <AuthContext.Provider value={machine}>
+      {children}
+    </AuthContext.Provider>
+  )
+}
+```
+
+`useMachineAtom` strongly owns one machine atom, mounts it after commit, and
+does not subscribe the owner to machine state. Descendants subscribe to the
+specific state paths they render with `AtomMachine.select`,
+`AtomMachine.selectSnapshot`, or `AtomMachine.matches`.
+
+Machine input is startup-only. Send an event to update a running workflow, or
+change the provider's React `key` to replace it with a new machine.

package/dist/MachineAtom.d.ts

@@ -0,0 +1,16 @@
+import type { AtomMachine } from "@typeonce/effect-machine/reactivity";
+type AnyMachineAtom = AtomMachine.MachineAtom<any, never, any, any, any, any>;
+/**
+ * Creates one machine atom for a committed React owner and mounts its machine
+ * reference without subscribing the owner to machine state.
+ *
+ * The factory is startup-only. Later changes to values captured by the factory
+ * do not replace the machine. Send an event to change a running workflow, or
+ * change the owner's React `key` to create a new machine.
+ *
+ * @category hooks
+ * @since 0.29.0
+ */
+export declare const useMachineAtom: <A extends AnyMachineAtom>(create: () => A) => A;
+export {};
+//# sourceMappingURL=MachineAtom.d.ts.map

package/dist/MachineAtom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MachineAtom.d.ts","sourceRoot":"","sources":["../src/MachineAtom.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAA;AAGtE,KAAK,cAAc,GAAG,WAAW,CAAC,WAAW,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;AAE7E;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,cAAc,EAAE,QAAQ,MAAM,CAAC,KAAG,CAI1E,CAAA"}

package/dist/MachineAtom.js

@@ -0,0 +1,25 @@
+/**
+ * React ownership for machine atoms.
+ *
+ * @since 0.29.0
+ */
+"use client";
+import { useAtomMount } from "@effect/atom-react";
+import * as React from "react";
+/**
+ * Creates one machine atom for a committed React owner and mounts its machine
+ * reference without subscribing the owner to machine state.
+ *
+ * The factory is startup-only. Later changes to values captured by the factory
+ * do not replace the machine. Send an event to change a running workflow, or
+ * change the owner's React `key` to create a new machine.
+ *
+ * @category hooks
+ * @since 0.29.0
+ */
+export const useMachineAtom = (create) => {
+    const [machine] = React.useState(create);
+    useAtomMount(machine.ref);
+    return machine;
+};
+//# sourceMappingURL=MachineAtom.js.map

package/dist/MachineAtom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MachineAtom.js","sourceRoot":"","sources":["../src/MachineAtom.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,YAAY,CAAA;AAEZ,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAI9B;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAA2B,MAAe,EAAK,EAAE;IAC7E,MAAM,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;IACxC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IACzB,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * React ownership hooks for Effect Machine atoms.
+ *
+ * @since 0.29.0
+ */
+export * from "./MachineAtom.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,kBAAkB,CAAA"}

package/dist/index.js

@@ -0,0 +1,7 @@
+/**
+ * React ownership hooks for Effect Machine atoms.
+ *
+ * @since 0.29.0
+ */
+export * from "./MachineAtom.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,kBAAkB,CAAA"}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@typeonce/effect-machine-react",
+  "version": "0.28.0",
+  "description": "React ownership hooks for Effect Machine atoms",
+  "author": "Sandro Maglione",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/typeonce-dev/effect-machine.git",
+    "directory": "packages/effect-machine-react"
+  },
+  "bugs": {
+    "url": "https://github.com/typeonce-dev/effect-machine/issues"
+  },
+  "homepage": "https://github.com/typeonce-dev/effect-machine/tree/main/packages/effect-machine-react#readme",
+  "type": "module",
+  "license": "MIT",
+  "sideEffects": false,
+  "files": [
+    "src/**/*.ts",
+    "dist",
+    "README.md",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@typeonce/effect-machine": "^0.28.0"
+  },
+  "peerDependencies": {
+    "@effect/atom-react": "4.0.0-rc.112",
+    "effect": "4.0.0-rc.112",
+    "react": ">=19.0.0 <20.0.0",
+    "scheduler": ">=0.25.0 <0.28.0"
+  },
+  "devDependencies": {
+    "@effect/atom-react": "4.0.0-rc.112",
+    "@testing-library/react": "16.3.0",
+    "@types/react": "19.2.16",
+    "@types/react-dom": "19.2.3",
+    "effect": "4.0.0-rc.112",
+    "jsdom": "27.2.0",
+    "react": "19.2.7",
+    "react-dom": "19.2.7",
+    "scheduler": "0.27.0",
+    "tstyche": "7.2.1",
+    "typescript": "6.0.3",
+    "vitest": "4.1.10"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -b tsconfig.build.json",
+    "check": "tsc -b tsconfig.json",
+    "test:types": "tstyche"
+  }
+}

package/src/MachineAtom.ts

@@ -0,0 +1,29 @@
+/**
+ * React ownership for machine atoms.
+ *
+ * @since 0.29.0
+ */
+"use client"
+
+import { useAtomMount } from "@effect/atom-react"
+import type { AtomMachine } from "@typeonce/effect-machine/reactivity"
+import * as React from "react"
+
+type AnyMachineAtom = AtomMachine.MachineAtom<any, never, any, any, any, any>
+
+/**
+ * Creates one machine atom for a committed React owner and mounts its machine
+ * reference without subscribing the owner to machine state.
+ *
+ * The factory is startup-only. Later changes to values captured by the factory
+ * do not replace the machine. Send an event to change a running workflow, or
+ * change the owner's React `key` to create a new machine.
+ *
+ * @category hooks
+ * @since 0.29.0
+ */
+export const useMachineAtom = <A extends AnyMachineAtom>(create: () => A): A => {
+  const [machine] = React.useState(create)
+  useAtomMount(machine.ref)
+  return machine
+}

package/src/index.ts

@@ -0,0 +1,7 @@
+/**
+ * React ownership hooks for Effect Machine atoms.
+ *
+ * @since 0.29.0
+ */
+
+export * from "./MachineAtom.js"