@tutti-os/ui-system 0.0.227 → 0.0.229

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.227",
3
+ "version": "0.0.229",
4
4
  "private": false,
5
5
  "type": "module",
6
6
  "types": "./dist/index.d.ts",
package/ui-system.md CHANGED
@@ -52,14 +52,20 @@ disabled, keyboard-focus, and overlay states.
52
52
  ## Avatar foundation
53
53
 
54
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.
55
+ image loading, rendered-box-aware image transformation, broken-image fallback,
56
+ initial or empty fallback modes, loading presentation, named or numeric sizing,
57
+ and a caller-owned overlay slot through `children`. Sources are requested
58
+ unchanged by default. When the caller passes `transform`, HTTP(S) sources
59
+ request a bucketed two-times-size WebP variant with `fit=inside`, while
60
+ preserving the original query string. A failed variant retries the original
61
+ source once. Consumers own identity resolution, directly consumable image URLs,
62
+ transformation capability, labels, fallback colors, presence semantics, and
63
+ overlay content. They never pass buckets or object keys to the component.
64
+ The underlying Radix/shadcn parts are intentionally not public. `fallbackColor`
65
+ is the narrow exception for caller-owned dynamic identity data; component
66
+ defaults still use semantic tokens. Initial fallback content appears only when
67
+ both the delivered image and its original fallback are unavailable, never
68
+ while a valid image URL is still loading.
63
69
 
64
70
  ## Current Package Role
65
71