@gratiaos/ui 1.0.4 → 1.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +13 -0
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -65,6 +65,19 @@ Short purpose notes (see Playground for full demos):
65
65
 
66
66
  Each primitive maps to **global design tokens**, so themes and local contexts stay in sync.
67
67
 
68
+ ### ðŸŠī Reactive State (Signals)
69
+
70
+ Garden UI stays headless; it does not bundle a state system. For tiny local reactive values (e.g. live counters, inline mood flags, demo toggles) use the micro primitive `@gratiaos/signal`:
71
+
72
+ ```ts
73
+ import { createSignal } from '@gratiaos/signal';
74
+ const count$ = createSignal(0);
75
+ count$.subscribe((v) => console.log('count', v));
76
+ count$.set(count$.value + 1);
77
+ ```
78
+
79
+ Connect signals to primitives by reading their current value in render and subscribing in effects (or bridging through your own hooks). This keeps UI lean while enabling fine-grained reactivity without a large framework.
80
+
68
81
  ---
69
82
 
70
83
  ## 🔔 Toasts (quick start)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@gratiaos/ui",
3
- "version": "1.0.4",
3
+ "version": "1.0.5",
4
4
  "funding": "https://github.com/sponsors/GratiaOS",
5
5
  "type": "module",
6
6
  "license": "AGPL-3.0-only",