@triggery/core 0.1.0 → 0.1.2

package/CHANGELOG.md

@@ -1,5 +1,40 @@
 # @triggery/core
 
+## 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.
+
+## 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.
+
 ## 0.1.0
 
 First public preview release.

package/README.md

@@ -1,23 +1,201 @@
 # @triggery/core
 
-Core runtime for [Triggery](https://github.com/triggeryjs/triggery) — a declarative orchestration layer for React business logic.
+The runtime that powers [Triggery](https://github.com/triggeryjs/triggery) — a declarative `event → conditions → actions` orchestration layer.
 
-This package contains:
-
-- `createTrigger<Schema>(config)` — define a trigger.
-- `createRuntime()` — isolated runtime (registry + scheduler + inspector).
-- `getDefaultRuntime()` / `setDefaultRuntime()` — global singleton.
-- Lifecycle middleware chain.
-- Public types and helpers.
-
-You usually do not consume this package directly — use [`@triggery/react`](../react).
+**Framework-agnostic.** `@triggery/core` has **zero runtime dependencies** and knows nothing about React, Solid or Vue. The framework bindings (`@triggery/react`, `@triggery/solid`, `@triggery/vue`) and the state adapters are thin layers on top of this runtime — and they can be replaced by anything you author yourself in ~50 lines.
 
 ## Install
 
 ```bash
 pnpm add @triggery/core
+# plus your framework binding of choice (see below)
+```
+
+## Quick start
+
+The trigger definition is the same regardless of framework — only the wiring differs. Start by defining a scenario:
+
+```ts
+// src/triggers/message.trigger.ts
+import { createTrigger } from '@triggery/core';
+
+type Settings = { sound: boolean; notifications: boolean };
+
+export const messageTrigger = createTrigger<{
+  events: { 'new-message': { text: string; author: string } };
+  conditions: { settings: Settings };
+  actions: { showToast: { title: string; body: string } };
+}>({
+  id: 'message-received',
+  events: ['new-message'],
+  required: ['settings'],
+  handler({ event, conditions, actions }) {
+    if (!conditions.settings.notifications) return;
+    actions.showToast?.({
+      title: event.payload.author,
+      body: event.payload.text,
+    });
+  },
+});
+```
+
+Then wire it to your framework — pick one.
+
+### React
+
+```bash
+pnpm add @triggery/core @triggery/react
+```
+
+```tsx
+// src/main.tsx
+import { createRuntime } from '@triggery/core';
+import { TriggerRuntimeProvider, useAction, useCondition, useEvent } from '@triggery/react';
+import { useState } from 'react';
+import { createRoot } from 'react-dom/client';
+import { messageTrigger } from './triggers/message.trigger.ts';
+
+const runtime = createRuntime();
+
+function SettingsProvider() {
+  const [settings] = useState({ sound: true, notifications: true });
+  useCondition(messageTrigger, 'settings', () => settings, [settings]);
+  return null;
+}
+function Chat() {
+  const fire = useEvent(messageTrigger, 'new-message');
+  return <button onClick={() => fire({ text: 'hi', author: 'Alice' })}>send</button>;
+}
+function Toast() {
+  useAction(messageTrigger, 'showToast', ({ title, body }) => console.log(`[${title}] ${body}`));
+  return null;
+}
+
+createRoot(document.getElementById('root')!).render(
+  <TriggerRuntimeProvider runtime={runtime}>
+    <SettingsProvider /><Chat /><Toast />
+  </TriggerRuntimeProvider>,
+);
+```
+
+Full walkthrough: [`@triggery/react` README](https://github.com/triggeryjs/triggery/blob/main/packages/react/README.md). Runnable example: [`examples/vite-react-counter`](https://github.com/triggeryjs/triggery/tree/main/examples/vite-react-counter).
+
+### Solid
+
+```bash
+pnpm add @triggery/core @triggery/solid solid-js
+```
+
+```tsx
+// src/index.tsx
+import { createRuntime } from '@triggery/core';
+import { TriggerRuntimeProvider, useAction, useCondition, useEvent } from '@triggery/solid';
+import { createSignal } from 'solid-js';
+import { render } from 'solid-js/web';
+import { messageTrigger } from './triggers/message.trigger.ts';
+
+const runtime = createRuntime();
+
+const SettingsProvider = () => {
+  const [settings] = createSignal({ sound: true, notifications: true });
+  useCondition(messageTrigger, 'settings', () => settings());
+  return null;
+};
+const Chat = () => {
+  const fire = useEvent(messageTrigger, 'new-message');
+  return <button onClick={() => fire({ text: 'hi', author: 'Alice' })}>send</button>;
+};
+const Toast = () => {
+  useAction(messageTrigger, 'showToast', ({ title, body }) => console.log(`[${title}] ${body}`));
+  return null;
+};
+
+render(
+  () => (
+    <TriggerRuntimeProvider runtime={runtime}>
+      <SettingsProvider /><Chat /><Toast />
+    </TriggerRuntimeProvider>
+  ),
+  document.getElementById('root')!,
+);
+```
+
+Full walkthrough: [`@triggery/solid` README](https://github.com/triggeryjs/triggery/blob/main/packages/solid/README.md).
+
+### Vue 3
+
+```bash
+pnpm add @triggery/core @triggery/vue vue
+```
+
+```ts
+// src/main.ts
+import { createRuntime } from '@triggery/core';
+import { TriggerRuntimeProvider } from '@triggery/vue';
+import { createApp, defineComponent, h, ref } from 'vue';
+import { useAction, useCondition, useEvent } from '@triggery/vue';
+import { messageTrigger } from './triggers/message.trigger';
+
+const runtime = createRuntime();
+
+const SettingsProvider = defineComponent({
+  setup() {
+    const settings = ref({ sound: true, notifications: true });
+    useCondition(messageTrigger, 'settings', () => settings.value);
+    return () => null;
+  },
+});
+const Chat = defineComponent({
+  setup() {
+    const fire = useEvent(messageTrigger, 'new-message');
+    return () => h('button', { onClick: () => fire({ text: 'hi', author: 'Alice' }) }, 'send');
+  },
+});
+const Toast = defineComponent({
+  setup() {
+    useAction(messageTrigger, 'showToast', ({ title, body }) => console.log(`[${title}] ${body}`));
+    return () => null;
+  },
+});
+
+createApp({
+  setup: () => () =>
+    h(TriggerRuntimeProvider, { runtime }, () => [h(SettingsProvider), h(Chat), h(Toast)]),
+}).mount('#app');
 ```
 
+Full walkthrough (with `<script setup>` SFC style): [`@triggery/vue` README](https://github.com/triggeryjs/triggery/blob/main/packages/vue/README.md).
+
+## What's in this package
+
+- `createTrigger<Schema>(config)` — declare a scenario in one file (events, conditions, required gate, handler).
+- `createRuntime(options)` — instantiate an isolated runtime: indexed dispatch (`Map<eventKey, RuntimeTrigger[]>`), microtask + sync schedulers, middleware chain (`onFire` / `onBeforeMatch` / `onSkip` / `onActionStart` / `onActionEnd` / `onError` / `onCascade`), cascade safety (depth limit + cycle detection), inspector ring buffer with DEV/PROD auto-detection.
+- `getDefaultRuntime()` / `setDefaultRuntime()` — global singleton for apps that don't want explicit provider wiring.
+- Concurrency strategies for async handlers (`take-latest` / `take-every` / `take-first` / `queue` / `exhaust` / `sync`) with `AbortSignal`.
+- `actions.debounce / throttle / defer / queue` chainable action wrappers.
+- Last-mount-wins ownership with DEV warn-once.
+
+## Why "framework-agnostic"
+
+The runtime is a plain object with a `Map`-based registry. It does not import React. It does not import a vDOM. It can be embedded in:
+
+- a worker / service worker
+- a Node.js process (CLI, server, edge)
+- React Native (no DOM adapters needed for the runtime itself)
+- a vanilla JS page
+
+The same `createTrigger({...})` declaration runs unchanged across all of those. Bindings only wire `useEvent` / `useCondition` / `useAction` to the host framework's lifecycle.
+
+## Related packages
+
+- [`@triggery/react`](https://www.npmjs.com/package/@triggery/react) — React bindings (`useEvent` / `useCondition` / `useAction`).
+- [`@triggery/solid`](https://www.npmjs.com/package/@triggery/solid) — SolidJS bindings — same hook API.
+- [`@triggery/vue`](https://www.npmjs.com/package/@triggery/vue) — Vue 3 bindings — same hook API.
+- [`@triggery/testing`](https://www.npmjs.com/package/@triggery/testing) — Test utilities (`createTestRuntime`, `fakeScheduler`).
+- [`@triggery/vite`](https://www.npmjs.com/package/@triggery/vite) — Vite plugin for auto-discovery of `*.trigger.ts`.
+
+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/core",
-  "version": "0.1.0",
-  "description": "Declarative business-logic orchestration for React — core runtime",
+  "version": "0.1.2",
+  "description": "Declarative business-logic orchestration — framework-agnostic runtime (React, Solid, Vue, or any binding you write). Zero runtime dependencies.",
   "license": "MIT",
   "author": "Aleksey Skhomenko",
   "homepage": "https://triggeryjs.github.io/triggery",
@@ -22,13 +22,17 @@
     }
   ],
   "keywords": [
-    "react",
     "triggers",
     "events",
     "orchestration",
     "business-logic",
     "rule-engine",
-    "side-effects"
+    "side-effects",
+    "framework-agnostic",
+    "react",
+    "solid",
+    "vue",
+    "zero-dependencies"
   ],
   "type": "module",
   "main": "./dist/index.js",
@@ -51,7 +55,8 @@
   ],
   "sideEffects": false,
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "provenance": true
   },
   "devDependencies": {
     "tsup": "^8.5.1",