@wcstack/state 1.3.12 → 1.3.13

package/README.ja.md

@@ -148,11 +148,15 @@ Web Components のための宣言的リアクティブ状態管理。
 
 ### プリミティブ・オブジェクトプロパティ
 
-直接のプロパティ代入は任意の深さで検知されます：
+代入は**ドットパス記法**（ブラケット構文）を使用する必要があります。リアクティブ Proxy はトップレベルの `set` トラップのみを捕捉するため、通常のネストされたプロパティアクセスでは変更が検知されません：
 
 ```javascript
-this.count = 10;            // ✅ 検知される
-this.user.name = "Bob";     // ✅ 検知される（ネストされた代入）
+// ✅ パス代入 — 変更が検知される
+this.count = 10;
+this["user.name"] = "Bob";
+
+// ❌ 直接のネストアクセス — 変更が検知されない
+this.user.name = "Bob";     // Proxy の set トラップをバイパスする
 ```
 
 ### 配列

package/README.md

@@ -148,11 +148,15 @@ State changes are detected through **property assignment** (the Proxy `set` trap
 
 ### Primitive and Object Properties
 
-Direct property assignment is detected at any depth:
+Assignment must use **dot-path notation** (bracket syntax). The reactive proxy intercepts only top-level `set` traps, so standard nested property access bypasses change detection:
 
 ```javascript
-this.count = 10;            // ✅ detected
-this.user.name = "Bob";     // ✅ detected (nested assignment)
+// ✅ Path assignment — change detected
+this.count = 10;
+this["user.name"] = "Bob";
+
+// ❌ Direct nested access — change NOT detected
+this.user.name = "Bob";     // bypasses the Proxy set trap
 ```
 
 ### Arrays

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wcstack/state",
-  "version": "1.3.12",
+  "version": "1.3.13",
   "description": "Reactive state management with declarative data binding for Web Components. Zero dependencies, buildless.",
   "type": "module",
   "main": "./dist/index.esm.js",
@@ -40,14 +40,14 @@
     "declarative"
   ],
   "author": "mogera551",
-  "homepage": "https://github.com/nicari/wcstack/tree/main/packages/state#readme",
+  "homepage": "https://wcstack.github.io",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/nicari/wcstack.git",
+    "url": "https://github.com/wcstack/wcstack.git",
     "directory": "packages/state"
   },
   "bugs": {
-    "url": "https://github.com/nicari/wcstack/issues"
+    "url": "https://github.com/wcstack/wcstack/issues"
   },
   "license": "MIT",
   "devDependencies": {