@violetflux/kerros 0.2.1 → 0.2.2

package/README.md

@@ -24,7 +24,7 @@
 
 Kerros is a lightweight way to share state between React components.
 
-Write a Store the same way you write a custom Hook. When local state needs to be shared, pass it to `createStore`, mount its Provider, and let each component select what it needs.
+Write a Store the same way you write a custom Hook. When local state needs to be shared, pass it to `createStore`, mount its Provider, and let automatic tracking focus each component on the properties it reads.
 
 > [!TIP]
 > **Install with your coding agent** — paste this sentence into your coding agent to install both the dependency and the project Skill:
@@ -254,7 +254,7 @@ function createStore<TStore, TProps = Record<never, never>>(
 
 Most applications only need `createStore`. Use `bindStore` when a library or SDK already owns authoritative state outside React and exposes stable `getSnapshot` and `subscribe` functions.
 
-Without this API, an integration must either repeat the Context and selector subscription code or copy the external snapshot through a second Store. `bindStore` provides Provider scoping and selectors while keeping the original Store as the only state owner.
+Without this API, an integration must either repeat the Context and focused-subscription code or copy the external snapshot through a second Store. `bindStore` provides Provider scoping, selector-free automatic tracking, and explicit selectors while keeping the original Store as the only state owner.
 
 ```tsx
 const [useStream, StreamBindingProvider] = bindStore<Stream>('Stream')

package/README.zh-CN.md

@@ -16,7 +16,7 @@
 
 Kerros 是一个在 React 组件间共享状态的轻量方案。
 
-你怎么写 custom Hook，就可以怎么写 Store。只有当局部状态需要被多个组件使用时，再交给 `createStore`，用 Provider 决定共享范围，用 selector 选择组件真正需要的数据。
+你怎么写 custom Hook，就可以怎么写 Store。只有当局部状态需要被多个组件使用时，再交给 `createStore`，用 Provider 决定共享范围；组件直接解构需要的数据，Kerros 默认自动追踪实际访问的属性。
 
 > [!TIP]
 > **使用 Coding Agent 安装**：复制下面这句话并粘贴给你的 Coding Agent，它会同时安装依赖和当前项目的 Skill：
@@ -246,7 +246,7 @@ function createStore<TStore, TProps = Record<never, never>>(
 
 绝大多数应用只需要 `createStore`。只有当某个库或 SDK 已经在 React 外持有权威状态，并提供稳定的 `getSnapshot` 和 `subscribe` 函数时，才使用 `bindStore`。
 
-没有这个 API 时，集成层只能重复实现 Context 和 selector 订阅，或者把 External Store 快照复制进第二个 Store。`bindStore` 只提供 Provider 作用域和 selector，原 Store 仍是唯一状态所有者。
+没有这个 API 时，集成层只能重复实现 Context 和细粒度订阅，或者把 External Store 快照复制进第二个 Store。`bindStore` 提供 Provider 作用域、无 selector 自动追踪和显式 selector，原 Store 仍是唯一状态所有者。
 
 ```tsx
 const [useStream, StreamBindingProvider] = bindStore<Stream>('Stream')

package/dist/index.cjs

@@ -4,6 +4,7 @@ let proxy_compare = require("proxy-compare");
 let use_sync_external_store_shim_with_selector = require("use-sync-external-store/shim/with-selector");
 //#region src/tracking.ts
 const useStoreLayoutEffect$1 = typeof window === "undefined" ? react.useEffect : react.useLayoutEffect;
+const proxyTargetCache = /* @__PURE__ */ new WeakMap();
 /**
 * Subscribe through either an explicit selector, shallow snapshots, or render access tracking
 */
@@ -27,7 +28,7 @@ function useStoreValue(store, selector, tracking) {
 	const snapshot = (0, use_sync_external_store_shim_with_selector.useSyncExternalStoreWithSelector)(store.subscribe, store.getSnapshot, store.getSnapshot, selectSnapshot, compareSelections);
 	const affected = /* @__PURE__ */ new WeakMap();
 	const shouldTrack = !selector && tracking;
-	const value = shouldTrack ? (0, proxy_compare.createProxy)(snapshot, affected, proxyCache) : snapshot;
+	const value = shouldTrack ? (0, proxy_compare.createProxy)(snapshot, affected, proxyCache, proxyTargetCache) : snapshot;
 	useStoreLayoutEffect$1(() => {
 		if (shouldTrack) {
 			const renderedSnapshot = snapshot;
@@ -36,7 +37,7 @@ function useStoreValue(store, selector, tracking) {
 				snapshot: renderedSnapshot
 			};
 			const currentSnapshot = store.getSnapshot();
-			if ((0, proxy_compare.isChanged)(renderedSnapshot, currentSnapshot, affected, /* @__PURE__ */ new WeakMap())) calibrate(currentSnapshot);
+			if (!Object.is(renderedSnapshot, currentSnapshot) && (0, proxy_compare.isChanged)(renderedSnapshot, currentSnapshot, affected, /* @__PURE__ */ new WeakMap())) calibrate(currentSnapshot);
 		}
 	}, [
 		affected,

package/dist/index.mjs

@@ -3,6 +3,7 @@ import { createProxy, isChanged } from "proxy-compare";
 import { useSyncExternalStoreWithSelector } from "use-sync-external-store/shim/with-selector";
 //#region src/tracking.ts
 const useStoreLayoutEffect$1 = typeof window === "undefined" ? useEffect : useLayoutEffect;
+const proxyTargetCache = /* @__PURE__ */ new WeakMap();
 /**
 * Subscribe through either an explicit selector, shallow snapshots, or render access tracking
 */
@@ -26,7 +27,7 @@ function useStoreValue(store, selector, tracking) {
 	const snapshot = useSyncExternalStoreWithSelector(store.subscribe, store.getSnapshot, store.getSnapshot, selectSnapshot, compareSelections);
 	const affected = /* @__PURE__ */ new WeakMap();
 	const shouldTrack = !selector && tracking;
-	const value = shouldTrack ? createProxy(snapshot, affected, proxyCache) : snapshot;
+	const value = shouldTrack ? createProxy(snapshot, affected, proxyCache, proxyTargetCache) : snapshot;
 	useStoreLayoutEffect$1(() => {
 		if (shouldTrack) {
 			const renderedSnapshot = snapshot;
@@ -35,7 +36,7 @@ function useStoreValue(store, selector, tracking) {
 				snapshot: renderedSnapshot
 			};
 			const currentSnapshot = store.getSnapshot();
-			if (isChanged(renderedSnapshot, currentSnapshot, affected, /* @__PURE__ */ new WeakMap())) calibrate(currentSnapshot);
+			if (!Object.is(renderedSnapshot, currentSnapshot) && isChanged(renderedSnapshot, currentSnapshot, affected, /* @__PURE__ */ new WeakMap())) calibrate(currentSnapshot);
 		}
 	}, [
 		affected,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@violetflux/kerros",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Hook-native state sharing for React with automatic access tracking and focused selectors.",
   "keywords": [
     "react",