@tutti-os/ui-system 0.0.196 → 0.0.198

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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tutti-os/ui-system",
3
- "version": "0.0.196",
3
+ "version": "0.0.198",
4
4
  "private": false,
5
5
  "type": "module",
6
6
  "types": "./dist/index.d.ts",
package/ui-system.md CHANGED
@@ -49,6 +49,18 @@ recorded in the package `NOTICE`. Update that provenance whenever registry
49
49
  source is refreshed. Storyboard coverage is the visual inventory for enabled,
50
50
  disabled, keyboard-focus, and overlay states.
51
51
 
52
+ ## Avatar foundation
53
+
54
+ `Avatar` is the single high-level identity-image primitive. It owns decorative
55
+ image loading, broken-image fallback, initial or empty fallback modes, loading
56
+ presentation, named or numeric sizing, and a caller-owned overlay slot through
57
+ `children`. Consumers own identity resolution, image URLs, labels, fallback
58
+ colors, presence semantics, and overlay content. The underlying Radix/shadcn
59
+ parts are intentionally not public. `fallbackColor` is the narrow exception for
60
+ caller-owned dynamic identity data; component defaults still use semantic
61
+ tokens. Initial fallback content appears only when the image URL is absent or
62
+ the image fails, never while a valid image URL is still loading.
63
+
52
64
  ## Current Package Role
53
65
 
54
66
  `@tutti-os/ui-system` is the single source of truth for: