~ Document and test emit-less actions

Author: will-stone

README.md

@@ -321,6 +321,43 @@ Clicking `Reset` will put the `counter` back to `0`.
 > You can call `$reset()` without a field parameter to reset _all_ state in the
 > store.
 
+## Nested Actions
+
+Beginning an action name with a `$` will mean it won't emit subscription
+announcements at the end of the action. This can be useful if you wish to use
+actions from other actions.
+
+```tsx
+// store.ts
+import { TwoAndEight } from '2n8'
+
+class Store extends TwoAndEight {
+  counter = 0
+  face: '🫤' | '🥸' = '🫤'
+
+  $repeatedAction = () => {
+    this.counter++
+    // Will not emit when called but state will change.
+  }
+
+  action1 = (arg: boolean) => {
+    if (arg) {
+      this.$repeatedAction()
+    }
+    this.face = '🥸'
+  }
+
+  action2 = (arg: boolean) => {
+    if (!arg) {
+      this.$repeatedAction()
+    }
+    this.face = '🫤'
+  }
+}
+
+export const useStore = createReactStore(new Store())
+```
+
 ## Comparison
 
 2n8 feels like a blend between two excellent state management libraries:

src/2n8.test.tsx

@@ -627,6 +627,24 @@ test('should not fire subscription until end of action', () => {
   expect(subscribeSpy).toHaveBeenCalledTimes(2)
 })
 
+test('should not fire subscription if action begins with $ but state still updates', () => {
+  class Store extends TwoAndEight {
+    count = 999
+
+    $increment = () => {
+      this.count++
+    }
+  }
+
+  const { get, subscribe } = createStore(new Store())
+  const subscribeSpy = vi.fn<() => void>()
+  subscribe(subscribeSpy)
+  get('$increment')()
+
+  expect(get('count')).toBe(1000)
+  expect(subscribeSpy).not.toHaveBeenCalled()
+})
+
 test("should fail types when store hasn't extended super class", () => {
   class Store {
     count = 0