@triggery/testing 0.1.0 → 0.1.2

package/CHANGELOG.md

@@ -1,5 +1,47 @@
 # @triggery/testing
 
+## 0.1.2
+
+### Patch Changes
+
+- f23e155: Filled out the quick-start sections in the npm package READMEs that adopters land on first.
+
+  - `@triggery/core` README now contains a three-tab quick-start (React / Solid / Vue) with concrete `pnpm add` commands and runnable code, plus pointers to the per-binding README for the full walkthrough.
+  - `@triggery/react` README — was a stub. Now has the full four-file scenario (trigger + provider + Chat + Toast) ready to copy-paste, exactly mirroring the Solid and Vue examples.
+
+  Linked-bundle bump so the binding READMEs stay aligned with the core release; no code or API changes.
+
+- 3385f5b: Every package README now ends with a tailored **Related packages** section and a consistent `## License` footer.
+
+  - Adapter packages (`zustand`, `redux`, `jotai`, `mobx`, `reatom`, `signals`, `query`) link to `core` + `react` (required peers) plus 2-3 alternative adapters so adopters can swap them out without re-reading the whole repo.
+  - Event-source packages (`dom`, `socket`) cross-link.
+  - DevTools packages (`devtools-redux`, `devtools-panel`, `devtools-bridge`) cross-link.
+  - Tooling packages (`eslint-plugin`, `codemod`, `cli`) cross-link.
+  - Bindings (`react`, `solid`, `vue`) link to each other so users mid-migration know there's a sibling with the same hook API.
+  - `@triggery/core/src/index.ts` JSDoc header had stale wording ("orchestration runtime for React business logic") — replaced with framework-agnostic phrasing matching the README.
+
+  No code or API changes. Drop-in patch.
+
+- Updated dependencies [f23e155]
+- Updated dependencies [3385f5b]
+  - @triggery/core@0.1.2
+
+## 0.1.1
+
+### Patch Changes
+
+- 35936d1: Polished package metadata for framework-agnostic positioning.
+
+  - `@triggery/core` description corrected: it is **framework-agnostic** (React, Solid, Vue, or any binding you write), not React-only. Keywords now include `solid`, `vue`, `framework-agnostic`, `zero-dependencies`. README expanded to spell out what runs where.
+  - `@triggery/testing` README + description now mention **zero runtime dependencies** and that the kit works under Vitest, Jest, and `node:test` alike (no `vi.useFakeTimers` coupling).
+  - `@triggery/devtools-bridge`, `@triggery/devtools-redux`, `@triggery/vite` descriptions clarified as framework-agnostic / runtime-pure.
+  - `@triggery/react / solid / vue` descriptions now explicitly say **zero runtime dependencies** — the binding is a thin lifecycle adapter, nothing else.
+
+  No API or behaviour changes.
+
+- Updated dependencies [35936d1]
+  - @triggery/core@0.1.1
+
 ## 0.1.0
 
 First public preview release.

package/README.md

@@ -1,13 +1,6 @@
 # @triggery/testing
 
-Testing utilities for [Triggery](https://github.com/triggeryjs/triggery).
-
-Provides:
-
-- `createTestRuntime({ triggers })` — isolated runtime for tests.
-- `mockCondition(name, value)` / `mockAction(name, fn)` — replace ports without rendering React.
-- `fakeScheduler` — control time (advance, flush).
-- Vitest and Jest adapters.
+Testing utilities for [Triggery](https://github.com/triggeryjs/triggery). **Zero runtime dependencies. Framework-agnostic** — works the same in React, Solid, Vue tests, Node, or a worker; works with Vitest, Jest, and `node:test`.
 
 ## Install
 
@@ -15,6 +8,60 @@ Provides:
 pnpm add -D @triggery/testing
 ```
 
+## What's in the box
+
+- `createTestRuntime({ triggers? })` — isolated runtime per test (no global state pollution).
+- `mockCondition(trigger, name, value | getter)` — supply a condition without rendering a component.
+- `mockAction(trigger, name, fn)` — register an action handler (typically `vi.fn()` / `jest.fn()` / a closure).
+- `flushMicrotasks()` — drain the default microtask scheduler before asserting.
+- `createFakeScheduler()` — controllable virtual clock for `actions.debounce / throttle / defer`:
+  - `install()` / `uninstall()` swap `globalThis.setTimeout` / `clearTimeout` for a controlled implementation.
+  - `advance(ms)` runs every timer due within the window and drains microtasks.
+  - `flushAll()` runs every pending timer regardless of scheduled time.
+  - Test-runner agnostic — no dependency on `vi.useFakeTimers()`.
+
+## Example
+
+```ts
+import { createTrigger } from '@triggery/core';
+import { createTestRuntime } from '@triggery/testing';
+import { expect, test, vi } from 'vitest';
+
+test('mod with sound shows toast and plays sound', async () => {
+  const rt = createTestRuntime();
+  const t = createTrigger<{
+    events: { 'new-message': string };
+    conditions: { user: { isMod: boolean } };
+    actions: { showToast: string; playSound: 'beep' | 'mod-alert' };
+  }>(
+    {
+      id: 'msg',
+      events: ['new-message'],
+      required: ['user'],
+      handler: ({ event, conditions, actions, check }) => {
+        if (!check.is('user', (u) => u.isMod)) return;
+        actions.showToast?.(event.payload);
+        actions.playSound?.('mod-alert');
+      },
+    },
+    rt,
+  );
+
+  rt.mockCondition(t, 'user', { isMod: true });
+  const showToast = vi.fn();
+  rt.mockAction(t, 'showToast', showToast);
+
+  rt.fireSync('new-message', 'hi');
+  expect(showToast).toHaveBeenCalledWith('hi');
+});
+```
+
+## Related packages
+
+- [`@triggery/core`](https://www.npmjs.com/package/@triggery/core) — Required peer — `createTestRuntime` wraps `createRuntime`.
+
+See the [full package list](https://github.com/triggeryjs/triggery#packages) in the repo README.
+
 ## License
 
 MIT &copy; Aleksey Skhomenko

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@triggery/testing",
-  "version": "0.1.0",
-  "description": "Testing utilities for Triggery — isolated runtime, mock conditions/actions, fake scheduler",
+  "version": "0.1.2",
+  "description": "Testing utilities for Triggery — isolated runtime, fake scheduler, mock conditions/actions. Zero runtime dependencies, works with Vitest / Jest / node:test.",
   "license": "MIT",
   "author": "Aleksey Skhomenko",
   "homepage": "https://triggeryjs.github.io/triggery",
@@ -26,7 +26,11 @@
     "testing",
     "vitest",
     "jest",
-    "mocking"
+    "node-test",
+    "mocking",
+    "fake-timers",
+    "zero-dependencies",
+    "framework-agnostic"
   ],
   "type": "module",
   "main": "./dist/index.js",
@@ -49,16 +53,17 @@
   ],
   "sideEffects": false,
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "provenance": true
   },
   "peerDependencies": {
-    "@triggery/core": "0.1.0"
+    "@triggery/core": "0.1.2"
   },
   "devDependencies": {
     "tsup": "^8.5.1",
     "typescript": "^6.0.3",
     "vitest": "^4.1.6",
-    "@triggery/core": "0.1.0"
+    "@triggery/core": "0.1.2"
   },
   "scripts": {
     "build": "tsup",