doc: update decorator example to show private state and controlled mu…

…tations

packages/signal-polyfill/readme.md

@@ -87,6 +87,8 @@ export function effect(callback) {
 
 ### Combining signals and decorators
 
+A class accessor decorator can be combined with the `Signal.State()` API to enable improved DX.
+
 ```js
 import { Signal } from "signal-polyfill";
 
@@ -107,13 +109,26 @@ export function signal(target) {
     },
   };
 }
+```
+
+The above decorator can be used on public or **private** accessors, enabling reactivity while carefully controlling state mutations.
+
+```js
+export class Counter {
+  @signal accessor #value = 0;
+
+  get value() {
+    return this.#value;
+  }
 
-export class Person {
-  @signal accessor firstName = "";
-  @signal accessor lastName = "";
+  increment() {
+    this.#value++;
+  }
 
-  get fullName() {
-    return `${this.firstName} ${this.lastName}`;
+  decrement() {
+    if (this.#value > 0) {
+      this.#value--;
+    }
   }
 }
 ```