aieventjs 0.3.0 → 0.4.0

package/README.md

@@ -10,7 +10,7 @@
 
 Part of the [ai\*js micro-runtime ecosystem](https://github.com/yshengliao) — see also [aifsmjs](https://github.com/yshengliao/aifsmjs) (FSM), [aiecsjs](https://github.com/yshengliao/aiecsjs) (ECS), [aibridgejs](https://github.com/yshengliao/aibridgejs) (cross-context RPC), [aipooljs](https://github.com/yshengliao/aipooljs) (object pool), [aiquadtreejs](https://github.com/yshengliao/aiquadtreejs) (spatial partitioning), and [aiaudiojs](https://github.com/yshengliao/aiaudiojs) (Web Audio shell).
 
-> **Status: 0.3.0.** Full implementation shipped; all methods are live. Coverage ≥ 95/90/100/100; ~1050 B gzip (budget 1100 B).
+> **Status: 0.4.0.** Full implementation shipped; all methods are live. Coverage ≥ 95/90/100/100; ~1050 B gzip (budget 1100 B).
 
 ---
 
@@ -148,6 +148,7 @@ Full JSDoc lives in [`src/index.ts`](src/index.ts).
 | **0.0.1**  | Scaffold landed — frozen API surface as a `throw` stub; full config + CI walk clean.                                                |
 | **0.1.0**  | First npm release. `on` / `once` / `off` / `emit` / `clear` / `dispose` implemented; coverage ≥ 95/90/100/100; ≤ 800 B gzip (strict-TS overhead lands at ~747 B). |
 | **0.3.0**  | `captureHandlerErrors` + wildcard sampling/throttling. The v0.2 number was skipped to align with the four-package v0.3 release cohort. |
+| **0.4.0**  | Dependency hygiene + stability freeze: removed the unused `tsx` devDependency, aligned `fast-check` to `^4.8.0`, and froze the 0.3.x public surface for the 1.x line. No runtime API change; bundle byte-identical to 0.3.1. |
 | **0.6+**   | Async handler tracking (draft) — see [STABILITY.md](STABILITY.md).                                                                  |
 
 ---

package/llms-full.txt

@@ -23,7 +23,7 @@ The short index lives at `llms.txt` (see https://llmstxt.org/).
 
 Part of the [ai\*js micro-runtime ecosystem](https://github.com/yshengliao) — see also [aifsmjs](https://github.com/yshengliao/aifsmjs) (FSM), [aiecsjs](https://github.com/yshengliao/aiecsjs) (ECS), [aibridgejs](https://github.com/yshengliao/aibridgejs) (cross-context RPC), [aipooljs](https://github.com/yshengliao/aipooljs) (object pool), [aiquadtreejs](https://github.com/yshengliao/aiquadtreejs) (spatial partitioning), and [aiaudiojs](https://github.com/yshengliao/aiaudiojs) (Web Audio shell).
 
-> **Status: 0.3.0.** Full implementation shipped; all methods are live. Coverage ≥ 95/90/100/100; ~1050 B gzip (budget 1100 B).
+> **Status: 0.4.0.** Full implementation shipped; all methods are live. Coverage ≥ 95/90/100/100; ~1050 B gzip (budget 1100 B).
 
 ---
 
@@ -161,6 +161,7 @@ Full JSDoc lives in [`src/index.ts`](src/index.ts).
 | **0.0.1**  | Scaffold landed — frozen API surface as a `throw` stub; full config + CI walk clean.                                                |
 | **0.1.0**  | First npm release. `on` / `once` / `off` / `emit` / `clear` / `dispose` implemented; coverage ≥ 95/90/100/100; ≤ 800 B gzip (strict-TS overhead lands at ~747 B). |
 | **0.3.0**  | `captureHandlerErrors` + wildcard sampling/throttling. The v0.2 number was skipped to align with the four-package v0.3 release cohort. |
+| **0.4.0**  | Dependency hygiene + stability freeze: removed the unused `tsx` devDependency, aligned `fast-check` to `^4.8.0`, and froze the 0.3.x public surface for the 1.x line. No runtime API change; bundle byte-identical to 0.3.1. |
 | **0.6+**   | Async handler tracking (draft) — see [STABILITY.md](STABILITY.md).                                                                  |
 
 ---
@@ -181,6 +182,38 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-05-29
+
+Dependency hygiene + stability freeze. No runtime API addition; `dist/` is byte-identical to 0.3.1 (no `src/` change). Consumer-facing behaviour is unchanged.
+
+### Changed
+- Aligned the `fast-check` devDependency to `^4.8.0` (was `^3.23.0`), matching the newer ai*js family cohort. Test-only; never bundled; zero consumer impact.
+- Declared the entire 0.3.x public API surface frozen for the 1.x line — see STABILITY.md. No signatures, error names, or default behaviours changed.
+
+### Removed
+- `tsx` devDependency — unused (no script, config, test, or CI step referenced it). Trims the lockfile subtree; no functional impact.
+
+## [0.3.1] - 2026-05-29
+### Added
+- `test/emitter.prop.test.ts`: three fast-check property invariants — dispatch
+  order (typed before wildcard, registration order preserved), snapshot stability
+  under mid-dispatch `off()`, live-set accuracy after upfront unsubscribe.
+  `numRuns: 100`; inline `fc.assert` style matching family convention.
+- `test/wildcard-throttle.test.ts` §F: five edge-case tests — pre-aborted signal
+  + valid `sampleRate` never registers; `on()` guard-before-signal ordering;
+  `captureErrors` + signal leak check (`removeEventListener` called on abort);
+  throttled wildcard + mid-dispatch abort (snapshot-in-flight completes);
+  `sampleRate` exact boundary (`Math.random() === sampleRate` is a miss).
+- `test/capture-errors.test.ts` §F: dispose-during-capturing-dispatch —
+  snapshot completes; `EmitterDisposedError` from re-entrant `emit()` is routed
+  through the capture callback; sibling handler still runs.
+- `fast-check ^3.23.0` devDependency (family convention: aifsmjs `^3.20.0`,
+  aiquadtreejs `^3.23.0`).
+
+### Changed
+- No `src/index.ts` behaviour change. `dist/` is byte-identical to v0.3.0.
+  gzip 1050 B / 1100 B unchanged.
+
 ## [0.3.0] - 2026-05-29
 ### Added
 - `EmitterOptions.captureHandlerErrors`: opt-in emitter-level error policy. Accepts `true` (swallow) or `(err, type, payload) => void` callback. Default behaviour (first throw aborts dispatch) is unchanged.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aieventjs",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Small, strict, typed event emitter — on() returns an unsubscribe function, once is built-in, AbortSignal is first-class, dispose() is idempotent, wildcard '*' handlers preserved. Mitt-shaped API; ai*js conventions everywhere else.",
   "keywords": [
     "event-emitter",
@@ -61,8 +61,8 @@
     "@biomejs/biome": "^1.9.0",
     "@types/node": "^22.0.0",
     "@vitest/coverage-v8": "^4.1.7",
+    "fast-check": "^4.8.0",
     "tsup": "^8.3.0",
-    "tsx": "^4.22.3",
     "typescript": "^5.6.0",
     "vite": "^8.0.14",
     "vitest": "^4.1.7"