stroid 0.1.2 → 0.1.4-beta.0

package/CHANGELOG.md

@@ -5,9 +5,56 @@ Format: [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 Versioning: [Semantic Versioning](https://semver.org/).
 
 ---
-<details open>
-<summary><strong>Unreleased Changes</strong></summary>
->
+<details open>
+<summary><strong>Unreleased</strong></summary>
+
+- No unreleased changes yet.
+
+</details>
+
+---
+
+<details>
+<summary><strong>0.1.4-beta.0 --> 2026-03-23</strong></summary>
+
+- Added `stroid/psr` as a dedicated native PSR contract entrypoint with committed-only no-track snapshot reads, observation helpers, and explicit timing-contract reporting.
+- Added a canonical `RuntimePatch` model under the PSR surface and lowered `setStore`, `replaceStore`, `resetStore`, and `hydrateStores` into serializable runtime patch records internally.
+- Added public PSR patch-write APIs via `applyStorePatch()` and `applyStorePatchesAtomic()` for canonical `set` and root-level `merge` patches.
+- Hardened transaction commit semantics so failed batched commits roll back staged store state, reset metrics, and queued notifications, while commit-phase feature hook errors no longer break atomic batches.
+- Added computed classification descriptors plus snapshot evaluation APIs for Phase 5 PSR-native integration, defaulting unclassified computeds to `opaque` so only explicitly deterministic nodes are simulated.
+- Hardened Phase 6 graph identity with stable runtime node IDs, store-granularity runtime graphs, typed dependency edges, and PSR graph reads that accept both stable node IDs and legacy computed store names.
+- Hardened Phase 7 timing semantics with explicit governance modes, mutation authority, causality-boundary reporting, and concrete contract reasons for async persistence, sync authority sharing, and async-boundary computed propagation.
+- Added a Phase 8 faithfulness suite that locks preview-vs-commit equivalence for deterministic public PSR flows, verifies public atomic rollback visibility rules, exercises async-boundary stop conditions, and smoke-tests production usage from only public entrypoints.
+- Hardened production SSR computed registration so computed stores inherit explicit global SSR opt-in from already-global dependencies and fail cleanly without leaving stray computed registrations when global creation is unsupported.
+- Added a 250K unique-subscriber benchmark, a 250K concurrent subscriber benchmark with real-world multi-store fanout scenarios, and lean performance-suite coverage for concurrent subscriber and sync broadcast timing; refreshed benchmark harnesses to use explicit feature installers and truly unique subscriber callbacks.
+- Breaking: changed `stroid/persist`, `stroid/sync`, and `stroid/devtools` to side-effect-free modules that export explicit installers (`installPersist`, `installSync`, `installDevtools`) instead of auto-registering on import.
+- Updated package exports, docs, and feature-install guidance to make optional feature registration explicit and more tree-shakeable.
+- Stopped publishing `.map` source maps in the npm tarball to reduce package weight while keeping local build/debug output unchanged.
+- Removed dead `./vue` and `./svelte` package exports that did not have built output behind them.
+
+</details>
+
+---
+
+<details>
+<summary><strong>0.1.3 --> 2026-03-22</strong></summary>
+
+- Fixed async rate limiting so `fetchStore(..., { cacheKey })` is throttled per `cacheSlot` instead of incorrectly sharing one counter across the whole store name.
+- Fixed `createSelector` dependency tracking for object-valued reads so cached selector results no longer go stale when object references change without primitive leaf access.
+- Fixed `setStoreBatch` teardown so a later commit-phase feature error does not discard notifications that were already queued by earlier successful commits.
+- Fixed persist unload listeners so deleting and recreating a persisted store no longer accumulates stale `pagehide` / `beforeunload` flush handlers.
+- Fixed sync-applied remote state so feature write hooks still run, allowing `persist` and other write-driven features to observe synced updates.
+- Fixed `clearAllStores()` under `assertRuntime: true` so a successful clear logs normally instead of throwing from the success path.
+- Fixed sync checksum handling so incoming sync payloads are now verified before remote state is accepted.
+- Fixed async request defaults so bodyless `GET` / `HEAD` / `DELETE` requests no longer send `Content-Type: application/json`.
+- Fixed `createComputed(..., { autoDispose: true })` so computed stores are removed after their last dependency is deleted.
+- Fixed `resetStore()` for falsy initial values (`false`, `0`, `""`, `null`) so registered stores no longer report `not-found` during reset.
+- Replaced the default registry scope's `import.meta.url`-based identifier with a stable bundler-safe string to avoid webpack / Next.js resolution failures.
+- Hardened SSR write-context isolation by routing `runWithWriteContext(...)` through the server AsyncLocalStorage runner instead of relying only on a module-level fallback context.
+- Hardened inline notification delivery to snapshot the subscriber list per flush instead of reusing a shared registry buffer.
+- Tightened React hook type coverage for ambient `StoreStateMap` usage, including `useStore`, `useStoreField`, `useStoreStatic`, `useSelector`, `useFormStore`, `useAsyncStore`, and `useAsyncStoreSuspense`.
+- Clarified React selector recreation warnings and docs so they describe selector churn and cache reuse accurately instead of implying repeated re-subscriptions.
+- Upgraded the transitive `flatted` resolution to `3.4.2` via `npm overrides` to address the Dependabot alert in the eslint / flat-cache toolchain path.
 
 </details>
 
@@ -15,7 +62,7 @@ Versioning: [Semantic Versioning](https://semver.org/).
 
 
 <details>
-<summary><strong>v0.1.2 — 2026-03-19</strong></summary>
+<summary><strong>0.1.2 --> 2026-03-19</strong></summary>
 > **Note:** This release contains breaking changes to the `stroid/core` export surface and hydration defaults to improve bundle size and security.
 
 - `hydrateStores` now requires an explicit trust argument at the TypeScript level (compile-time enforcement).
@@ -113,7 +160,7 @@ Versioning: [Semantic Versioning](https://semver.org/).
 ---
 
 <details>
-<summary><strong>0.1.1 — 2026-03-15</strong></summary>
+<summary><strong>0.1.1 --> 2026-03-15</strong></summary>
 
 ### Breaking
 
@@ -150,7 +197,7 @@ Versioning: [Semantic Versioning](https://semver.org/).
 ---
 
 <details>
-<summary><strong>0.1.0 — 2026-03-14</strong></summary>
+<summary><strong>0.1.0 --> 2026-03-14</strong></summary>
 
 ### Added
 
@@ -184,7 +231,7 @@ Versioning: [Semantic Versioning](https://semver.org/).
 ---
 
 <details>
-<summary><strong>0.0.4 — 2026-03-06</strong></summary>
+<summary><strong>0.0.4 --> 2026-03-06</strong></summary>
 
 ### Added
 
@@ -207,7 +254,7 @@ Versioning: [Semantic Versioning](https://semver.org/).
 ---
 
 <details>
-<summary><strong>0.0.3 — 2026-03-04</strong></summary>
+<summary><strong>0.0.3 --> 2026-03-04</strong></summary>
 
 ### Fixed
 
@@ -224,7 +271,7 @@ Versioning: [Semantic Versioning](https://semver.org/).
 ---
 
 <details>
-<summary><strong>0.0.2 — 2026-03-03</strong></summary>
+<summary><strong>0.0.2 --> 2026-03-03</strong></summary>
 
 ### Added
 
@@ -242,7 +289,7 @@ Versioning: [Semantic Versioning](https://semver.org/).
 ---
 
 <details>
-<summary><strong>0.0.1 — Initial Release</strong></summary>
+<summary><strong>0.0.1 --> Initial Release</strong></summary>
 
 - tsup-minified ESM bundles with subpath outputs.
 - `useStore` selector overload with dev warning on broad subscriptions.

package/README.md

@@ -62,9 +62,9 @@ Each row is independent. Use only what you need.
 - `stroid/async`: `fetchStore`, cache, retry, revalidate helpers.
 - `stroid/selectors`: `createSelector`, `subscribeWithSelector`.
 - `stroid/computed`: `createComputed`, `invalidateComputed`, `deleteComputed`, `isComputedStore`.
-- `stroid/persist`: Side-effect registration for persistence (localStorage/sessionStorage). Not tree-shakeable.
-- `stroid/sync`: Side-effect registration for BroadcastChannel sync. Not tree-shakeable.
-- `stroid/devtools`: Side-effect registration for Redux DevTools bridge. Not tree-shakeable.
+- `stroid/persist`: Explicit persistence installer (`installPersist`) and related types. Side-effect free.
+- `stroid/sync`: Explicit sync installer (`installSync`) and related types. Side-effect free.
+- `stroid/devtools`: Explicit devtools installer (`installDevtools`) plus history helpers. Side-effect free.
 - `stroid/server`: SSR registry helpers (`createStoreForRequest`).
 - `stroid/helpers`: Entity/list/counter store helpers.
 - `stroid/runtime-tools`: Observability and diagnostics.
@@ -121,13 +121,15 @@ import { createSelector, subscribeWithSelector } from "stroid/selectors"
 import { createComputed, invalidateComputed,
          deleteComputed, isComputedStore }       from "stroid/computed"
 
-// Features (side-effect imports — register once at app entry)
-import "stroid/persist"
-import "stroid/sync"
-import "stroid/devtools"
+// Features (explicit install — call once at app entry)
+import { installPersist } from "stroid/persist"
+import { installSync } from "stroid/sync"
+import { installDevtools } from "stroid/devtools"
+
+installPersist()
+installSync()
+installDevtools()
 
-// Note: stroid/persist and stroid/sync are side-effect entrypoints only.
-// All types live on the main "stroid" entry.
 
 // Server / SSR
 import { createStoreForRequest } from "stroid/server"
@@ -144,7 +146,7 @@ import { listStores, getStoreMeta, getMetrics,
          getPersistQueueDepth }                  from "stroid/runtime-tools"
 import { clearAllStores, clearStores }           from "stroid/runtime-admin"
 
-// Devtools API (after `import "stroid/devtools"`)
+// Devtools API (after installDevtools())
 import { getHistory, clearHistory } from "stroid/devtools"
 
 // Config

package/dist/async.d.ts

@@ -1,5 +1,5 @@
 import { F as FetchInput } from './cache.js';
-import { a as StoreDefinition, b as StoreKey, c as StoreName } from './types.js';
+import { a as StoreDefinition, b as StoreKey, d as StoreName } from './types.js';
 import { F as FetchOptions } from './registry.js';
 export { a as AsyncStateAdapter, b as AsyncStateSnapshot } from './registry.js';
 import './utility.js';