@hanzogui/avatar 2.0.0

package/dist/esm/Avatar.native.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["jsx","_jsx","getTokens","getVariableValue","styled","createContextScope","withStaticProperties","Image","Square","getShapeSize","YStack","React","_type_of","obj","Symbol","constructor","AVATAR_NAME","createAvatarContext","createAvatarScope","AvatarProvider","useAvatarContext","IMAGE_NAME","AvatarImage","forwardRef","props","forwardedRef","_getShapeSize","__scopeAvatar","src","source","onLoadingStatusChange","imageProps","context","status","setStatus","useState","shapeSize","size","tokens","width","resolvedSrc","uri","useEffect","onImageLoadingStatusChange","fullscreen","zIndex","children","position","top","left","right","bottom","objectFit","Number","isNaN","height","ref","onError","onLoad","displayName","FALLBACK_NAME","AvatarFallbackFrame","name","AvatarFallback","styleable","delayMs","fallbackProps","canRender","setCanRender","timerId","setTimeout","clearTimeout","imageLoadingStatus","AvatarFrame","overflow","Avatar","avatarProps","setImageLoadingStatus","scope"],"sources":["../../src/Avatar.tsx"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/esm/index.js

@@ -0,0 +1,2 @@
+export * from "./Avatar.mjs";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["../../src/index.ts"],"sourcesContent":[null],"mappings":"AAAA,cAAc","ignoreList":[]}

package/dist/esm/index.mjs

@@ -0,0 +1,2 @@
+export * from "./Avatar.mjs";
+//# sourceMappingURL=index.mjs.map

package/dist/esm/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["../../src/index.ts"],"sourcesContent":[null],"mappings":"AAAA,cAAc","ignoreList":[]}

package/dist/esm/index.native.js

@@ -0,0 +1,2 @@
+export * from "./Avatar.native.js";
+//# sourceMappingURL=index.native.js.map

package/dist/esm/index.native.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["../../src/index.ts"],"sourcesContent":[null],"mappings":"AAAA,cAAc","ignoreList":[]}

package/dist/jsx/Avatar.mjs

@@ -0,0 +1,115 @@
+import { getTokens, getVariableValue, styled } from "@hanzo/gui-core";
+import { createContextScope } from "@hanzo/gui-create-context";
+import { withStaticProperties } from "@hanzo/gui-helpers";
+import { Image } from "@hanzo/gui-image";
+import { Square, getShapeSize } from "@hanzo/gui-shapes";
+import { YStack } from "@hanzo/gui-stacks";
+import * as React from "react";
+import { jsx } from "react/jsx-runtime";
+const AVATAR_NAME = "Avatar",
+  [createAvatarContext, createAvatarScope] = createContextScope(AVATAR_NAME),
+  [AvatarProvider, useAvatarContext] = createAvatarContext(AVATAR_NAME),
+  IMAGE_NAME = "AvatarImage",
+  AvatarImage = React.forwardRef((props, forwardedRef) => {
+    const {
+        __scopeAvatar,
+        src,
+        source,
+        onLoadingStatusChange = () => {},
+        ...imageProps
+      } = props,
+      context = useAvatarContext(IMAGE_NAME, __scopeAvatar),
+      [status, setStatus] = React.useState("idle"),
+      shapeSize = getVariableValue(getShapeSize(context.size,
+      // @ts-expect-error
+      {
+        tokens: getTokens()
+      })?.width),
+      resolvedSrc = src || (source && typeof source == "object" && "uri" in source ? source.uri : source);
+    return React.useEffect(() => {
+      setStatus(resolvedSrc ? "idle" : "error");
+    }, [resolvedSrc]), React.useEffect(() => {
+      onLoadingStatusChange(status), context.onImageLoadingStatusChange(status);
+    }, [status]), resolvedSrc ? /* @__PURE__ */jsx(YStack, {
+      fullscreen: !0,
+      zIndex: 1,
+      children: /* @__PURE__ */jsx(Image, {
+        position: "absolute",
+        top: 0,
+        left: 0,
+        right: 0,
+        bottom: 0,
+        objectFit: "cover",
+        ...(typeof shapeSize == "number" && !Number.isNaN(shapeSize) && {
+          width: shapeSize,
+          height: shapeSize
+        }),
+        ...imageProps,
+        ref: forwardedRef,
+        src: resolvedSrc,
+        onError: () => {
+          setStatus("error");
+        },
+        onLoad: () => {
+          setStatus("loaded");
+        }
+      })
+    }) : null;
+  });
+AvatarImage.displayName = IMAGE_NAME;
+const FALLBACK_NAME = "AvatarFallback",
+  AvatarFallbackFrame = styled(YStack, {
+    name: FALLBACK_NAME,
+    position: "absolute",
+    fullscreen: !0,
+    zIndex: 0
+  }),
+  AvatarFallback = AvatarFallbackFrame.styleable((props, forwardedRef) => {
+    const {
+        __scopeAvatar,
+        delayMs,
+        ...fallbackProps
+      } = props,
+      context = useAvatarContext(FALLBACK_NAME, __scopeAvatar),
+      [canRender, setCanRender] = React.useState(delayMs === void 0);
+    return React.useEffect(() => {
+      if (delayMs !== void 0) {
+        const timerId = setTimeout(() => setCanRender(!0), delayMs);
+        return () => clearTimeout(timerId);
+      }
+    }, [delayMs]), canRender && context.imageLoadingStatus !== "loaded" ? /* @__PURE__ */jsx(AvatarFallbackFrame, {
+      ...fallbackProps,
+      ref: forwardedRef
+    }) : null;
+  });
+AvatarFallback.displayName = FALLBACK_NAME;
+const AvatarFrame = styled(Square, {
+    name: AVATAR_NAME,
+    position: "relative",
+    overflow: "hidden"
+  }),
+  Avatar = withStaticProperties(React.forwardRef((props, forwardedRef) => {
+    const {
+        __scopeAvatar,
+        size = "$true",
+        ...avatarProps
+      } = props,
+      [imageLoadingStatus, setImageLoadingStatus] = React.useState("idle");
+    return /* @__PURE__ */jsx(AvatarProvider, {
+      size,
+      scope: __scopeAvatar,
+      imageLoadingStatus,
+      onImageLoadingStatusChange: setImageLoadingStatus,
+      children: /* @__PURE__ */jsx(AvatarFrame, {
+        size,
+        ...avatarProps,
+        ref: forwardedRef
+      })
+    });
+  }), {
+    Image: AvatarImage,
+    Fallback: AvatarFallback
+  });
+Avatar.displayName = AVATAR_NAME;
+export { Avatar, AvatarFallback, AvatarFallbackFrame, AvatarFrame, AvatarImage, createAvatarScope };
+//# sourceMappingURL=Avatar.mjs.map

package/dist/jsx/Avatar.mjs.map

@@ -0,0 +1 @@
+{"version":3,"names":["getTokens","getVariableValue","styled","createContextScope","withStaticProperties","Image","Square","getShapeSize","YStack","React","jsx","AVATAR_NAME","createAvatarContext","createAvatarScope","AvatarProvider","useAvatarContext","IMAGE_NAME","AvatarImage","forwardRef","props","forwardedRef","__scopeAvatar","src","source","onLoadingStatusChange","imageProps","context","status","setStatus","useState","shapeSize","size","tokens","width","resolvedSrc","uri","useEffect","onImageLoadingStatusChange","fullscreen","zIndex","children","position","top","left","right","bottom","objectFit","Number","isNaN","height","ref","onError","onLoad","displayName","FALLBACK_NAME","AvatarFallbackFrame","name","AvatarFallback","styleable","delayMs","fallbackProps","canRender","setCanRender","timerId","setTimeout","clearTimeout","imageLoadingStatus","AvatarFrame","overflow","Avatar","avatarProps","setImageLoadingStatus","scope","Fallback"],"sources":["../../src/Avatar.tsx"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/jsx/Avatar.native.js

@@ -0,0 +1,172 @@
+"use strict";
+
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf,
+  __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+    for (var name in all) __defProp(target, name, {
+      get: all[name],
+      enumerable: !0
+    });
+  },
+  __copyProps = (to, from, except, desc) => {
+    if (from && typeof from == "object" || typeof from == "function") for (let key of __getOwnPropNames(from)) !__hasOwnProp.call(to, key) && key !== except && __defProp(to, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    });
+    return to;
+  };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+    value: mod,
+    enumerable: !0
+  }) : target, mod)),
+  __toCommonJS = mod => __copyProps(__defProp({}, "__esModule", {
+    value: !0
+  }), mod);
+var Avatar_exports = {};
+__export(Avatar_exports, {
+  Avatar: () => Avatar,
+  AvatarFallback: () => AvatarFallback,
+  AvatarFallbackFrame: () => AvatarFallbackFrame,
+  AvatarFrame: () => AvatarFrame,
+  AvatarImage: () => AvatarImage,
+  createAvatarScope: () => createAvatarScope
+});
+module.exports = __toCommonJS(Avatar_exports);
+var import_jsx_runtime = require("react/jsx-runtime"),
+  import_gui_core = require("@hanzo/gui-core"),
+  import_gui_create_context = require("@hanzo/gui-create-context"),
+  import_gui_helpers = require("@hanzo/gui-helpers"),
+  import_gui_image = require("@hanzo/gui-image"),
+  import_gui_shapes = require("@hanzo/gui-shapes"),
+  import_gui_stacks = require("@hanzo/gui-stacks"),
+  React = __toESM(require("react"), 1);
+function _type_of(obj) {
+  "@swc/helpers - typeof";
+
+  return obj && typeof Symbol < "u" && obj.constructor === Symbol ? "symbol" : typeof obj;
+}
+var AVATAR_NAME = "Avatar",
+  [createAvatarContext, createAvatarScope] = (0, import_gui_create_context.createContextScope)(AVATAR_NAME),
+  [AvatarProvider, useAvatarContext] = createAvatarContext(AVATAR_NAME),
+  IMAGE_NAME = "AvatarImage",
+  AvatarImage = /* @__PURE__ */React.forwardRef(function (props, forwardedRef) {
+    var _getShapeSize,
+      {
+        __scopeAvatar,
+        src,
+        source,
+        onLoadingStatusChange = function () {},
+        ...imageProps
+      } = props,
+      context = useAvatarContext(IMAGE_NAME, __scopeAvatar),
+      [status, setStatus] = React.useState("idle"),
+      shapeSize = (0, import_gui_core.getVariableValue)((_getShapeSize = (0, import_gui_shapes.getShapeSize)(context.size,
+      // @ts-expect-error
+      {
+        tokens: (0, import_gui_core.getTokens)()
+      })) === null || _getShapeSize === void 0 ? void 0 : _getShapeSize.width),
+      resolvedSrc = src || (source && (typeof source > "u" ? "undefined" : _type_of(source)) === "object" && "uri" in source ? source.uri : source);
+    return React.useEffect(function () {
+      setStatus(resolvedSrc ? "idle" : "error");
+    }, [resolvedSrc]), React.useEffect(function () {
+      onLoadingStatusChange(status), context.onImageLoadingStatusChange(status);
+    }, [status]), resolvedSrc ? /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_gui_stacks.YStack, {
+      fullscreen: !0,
+      zIndex: 1,
+      children: /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_gui_image.Image, {
+        position: "absolute",
+        top: 0,
+        left: 0,
+        right: 0,
+        bottom: 0,
+        objectFit: "cover",
+        ...(typeof shapeSize == "number" && !Number.isNaN(shapeSize) && {
+          width: shapeSize,
+          height: shapeSize
+        }),
+        ...imageProps,
+        // @ts-ignore
+        ref: forwardedRef,
+        // @ts-ignore
+        src: resolvedSrc,
+        // onLoadStart={() => {
+        //   // setStatus('loading')
+        // }}
+        onError: function () {
+          setStatus("error");
+        },
+        onLoad: function () {
+          setStatus("loaded");
+        }
+      })
+    }) : null;
+  });
+AvatarImage.displayName = IMAGE_NAME;
+var FALLBACK_NAME = "AvatarFallback",
+  AvatarFallbackFrame = (0, import_gui_core.styled)(import_gui_stacks.YStack, {
+    name: FALLBACK_NAME,
+    position: "absolute",
+    fullscreen: !0,
+    zIndex: 0
+  }),
+  AvatarFallback = AvatarFallbackFrame.styleable(function (props, forwardedRef) {
+    var {
+        __scopeAvatar,
+        delayMs,
+        ...fallbackProps
+      } = props,
+      context = useAvatarContext(FALLBACK_NAME, __scopeAvatar),
+      [canRender, setCanRender] = React.useState(delayMs === void 0);
+    return React.useEffect(function () {
+      if (delayMs !== void 0) {
+        var timerId = setTimeout(function () {
+          return setCanRender(!0);
+        }, delayMs);
+        return function () {
+          return clearTimeout(timerId);
+        };
+      }
+    }, [delayMs]), canRender && context.imageLoadingStatus !== "loaded" ? /* @__PURE__ */(0, import_jsx_runtime.jsx)(AvatarFallbackFrame, {
+      ...fallbackProps,
+      ref: forwardedRef
+    }) : null;
+  });
+AvatarFallback.displayName = FALLBACK_NAME;
+var AvatarFrame = (0, import_gui_core.styled)(import_gui_shapes.Square, {
+    name: AVATAR_NAME,
+    position: "relative",
+    overflow: "hidden"
+  }),
+  Avatar = (0, import_gui_helpers.withStaticProperties)(/* @__PURE__ */React.forwardRef(function (props, forwardedRef) {
+    var {
+        __scopeAvatar,
+        size = "$true",
+        ...avatarProps
+      } = props,
+      [imageLoadingStatus, setImageLoadingStatus] = React.useState("idle");
+    return /* @__PURE__ */(0, import_jsx_runtime.jsx)(AvatarProvider, {
+      size,
+      scope: __scopeAvatar,
+      imageLoadingStatus,
+      onImageLoadingStatusChange: setImageLoadingStatus,
+      children: /* @__PURE__ */(0, import_jsx_runtime.jsx)(AvatarFrame, {
+        size,
+        ...avatarProps,
+        ref: forwardedRef
+      })
+    });
+  }), {
+    Image: AvatarImage,
+    Fallback: AvatarFallback
+  });
+Avatar.displayName = AVATAR_NAME;
+//# sourceMappingURL=Avatar.native.js.map

package/dist/jsx/Avatar.native.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["__create","Object","create","__defProp","defineProperty","__getOwnPropDesc","getOwnPropertyDescriptor","__getOwnPropNames","getOwnPropertyNames","__getProtoOf","getPrototypeOf","__hasOwnProp","prototype","hasOwnProperty","__export","target","all","name","get","enumerable","__copyProps","to","from","except","desc","key","call","__toESM","mod","isNodeMode","__esModule","value","__toCommonJS","Avatar_exports","Avatar","AvatarFallback","AvatarFallbackFrame","AvatarFrame","AvatarImage","createAvatarScope","module","exports","import_jsx_runtime","require","import_gui_core","import_gui_create_context","import_gui_helpers","import_gui_image","import_gui_shapes","import_gui_stacks","React","_type_of","obj","Symbol","constructor","AVATAR_NAME","createAvatarContext","createContextScope","AvatarProvider","useAvatarContext","IMAGE_NAME","forwardRef","props","forwardedRef","_getShapeSize","__scopeAvatar","src","source","onLoadingStatusChange","imageProps","context","status","setStatus","useState","shapeSize","getVariableValue","getShapeSize","size","tokens","getTokens","width","resolvedSrc","uri","useEffect","onImageLoadingStatusChange","jsx","YStack","fullscreen","zIndex","children","Image","position","top","left","right","bottom","objectFit","Number","isNaN","height","ref","onError","onLoad","displayName","FALLBACK_NAME","styled","styleable","delayMs","fallbackProps","canRender","setCanRender"],"sources":["../../src/Avatar.tsx"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/jsx/index.js

@@ -0,0 +1,2 @@
+export * from "./Avatar.mjs";
+//# sourceMappingURL=index.js.map

package/dist/jsx/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["../../src/index.ts"],"sourcesContent":[null],"mappings":"AAAA,cAAc","ignoreList":[]}

package/dist/jsx/index.mjs

@@ -0,0 +1,2 @@
+export * from "./Avatar.mjs";
+//# sourceMappingURL=index.mjs.map

package/dist/jsx/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["../../src/index.ts"],"sourcesContent":[null],"mappings":"AAAA,cAAc","ignoreList":[]}

package/dist/jsx/index.native.js

@@ -0,0 +1,21 @@
+"use strict";
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+    if (from && typeof from == "object" || typeof from == "function") for (let key of __getOwnPropNames(from)) !__hasOwnProp.call(to, key) && key !== except && __defProp(to, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    });
+    return to;
+  },
+  __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = mod => __copyProps(__defProp({}, "__esModule", {
+  value: !0
+}), mod);
+var index_exports = {};
+module.exports = __toCommonJS(index_exports);
+__reExport(index_exports, require("./Avatar.native.js"), module.exports);
+//# sourceMappingURL=index.native.js.map

package/dist/jsx/index.native.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["../../src/index.ts"],"sourcesContent":[null],"mappings":"AAAA","ignoreList":[]}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@hanzogui/avatar",
+  "version": "2.0.0",
+  "source": "src/index.ts",
+  "files": [
+    "src",
+    "types",
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": [
+    "*.css"
+  ],
+  "main": "dist/cjs",
+  "module": "dist/esm",
+  "types": "./types/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./types/index.d.ts",
+      "react-native": "./dist/esm/index.native.js",
+      "browser": "./dist/esm/index.mjs",
+      "module": "./dist/esm/index.mjs",
+      "import": "./dist/esm/index.mjs",
+      "require": "./dist/cjs/index.cjs",
+      "default": "./dist/esm/index.mjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "hanzo-gui-build",
+    "watch": "hanzo-gui-build --watch",
+    "clean": "hanzo-gui-build clean",
+    "clean:build": "hanzo-gui-build clean:build"
+  },
+  "dependencies": {
+    "@hanzogui/core": "2.0.0-rc.29",
+    "@hanzogui/create-context": "2.0.0-rc.29",
+    "@hanzogui/helpers": "2.0.0-rc.29",
+    "@hanzogui/image": "2.0.0",
+    "@hanzogui/shapes": "2.0.0",
+    "@hanzogui/stacks": "2.0.0",
+    "@hanzogui/text": "2.0.0"
+  },
+  "devDependencies": {
+    "@hanzogui/build": "2.0.0-rc.29",
+    "react": ">=19",
+    "react-native": "0.83.2"
+  },
+  "peerDependencies": {
+    "react": ">=19",
+    "react-native": "*"
+  },
+  "module:jsx": "dist/jsx"
+}

package/src/Avatar.tsx

@@ -0,0 +1,212 @@
+// forked from radix https://github.com/radix-ui/primitives/blob/main/packages/react/avatar/src/Avatar.tsx
+
+import type { GetProps, SizeTokens, GuiElement } from '@hanzogui/core'
+import { getTokens, getVariableValue, styled } from '@hanzogui/core'
+import type { Scope } from '@hanzogui/create-context'
+import { createContextScope } from '@hanzogui/create-context'
+import { withStaticProperties } from '@hanzogui/helpers'
+import type { ImageProps } from '@hanzogui/image'
+import { Image } from '@hanzogui/image'
+import { Square, getShapeSize } from '@hanzogui/shapes'
+import { YStack } from '@hanzogui/stacks'
+import * as React from 'react'
+
+const AVATAR_NAME = 'Avatar'
+
+type ScopedProps<P> = P & { __scopeAvatar?: Scope }
+const [createAvatarContext, createAvatarScope] = createContextScope(AVATAR_NAME)
+
+type ImageLoadingStatus = 'idle' | 'loading' | 'loaded' | 'error'
+
+type AvatarContextValue = {
+  size: SizeTokens
+  imageLoadingStatus: ImageLoadingStatus
+  onImageLoadingStatusChange(status: ImageLoadingStatus): void
+}
+
+const [AvatarProvider, useAvatarContext] =
+  createAvatarContext<AvatarContextValue>(AVATAR_NAME)
+
+/* -------------------------------------------------------------------------------------------------
+ * AvatarImage
+ * -----------------------------------------------------------------------------------------------*/
+
+const IMAGE_NAME = 'AvatarImage'
+
+type AvatarImageProps = Partial<ImageProps> & {
+  onLoadingStatusChange?: (status: ImageLoadingStatus) => void
+}
+
+const AvatarImage = React.forwardRef<GuiElement, AvatarImageProps>(
+  (props: ScopedProps<AvatarImageProps>, forwardedRef) => {
+    const {
+      __scopeAvatar,
+      src,
+      source,
+      onLoadingStatusChange = () => {},
+      ...imageProps
+    } = props
+    const context = useAvatarContext(IMAGE_NAME, __scopeAvatar)
+    const [status, setStatus] = React.useState<ImageLoadingStatus>('idle')
+    const shapeSize = getVariableValue(
+      getShapeSize(
+        context.size,
+        // @ts-expect-error
+        { tokens: getTokens() }
+      )?.width
+    ) as number
+
+    // Support both `src` (web) and `source` (RN) props
+    const resolvedSrc =
+      src ||
+      (source && typeof source === 'object' && 'uri' in source ? source.uri : source)
+
+    React.useEffect(() => {
+      // If src is falsy, immediately set error status so fallback renders
+      if (!resolvedSrc) {
+        setStatus('error')
+      } else {
+        setStatus('idle')
+      }
+    }, [resolvedSrc])
+
+    React.useEffect(() => {
+      onLoadingStatusChange(status)
+      context.onImageLoadingStatusChange(status)
+    }, [status])
+
+    // Don't render Image if src is falsy to avoid Android warning
+    if (!resolvedSrc) {
+      return null
+    }
+
+    return (
+      <YStack fullscreen zIndex={1}>
+        <Image
+          position="absolute"
+          top={0}
+          left={0}
+          right={0}
+          bottom={0}
+          objectFit="cover"
+          {...(typeof shapeSize === 'number' &&
+            !Number.isNaN(shapeSize) && {
+              width: shapeSize,
+              height: shapeSize,
+            })}
+          {...imageProps}
+          // @ts-ignore
+          ref={forwardedRef}
+          // @ts-ignore
+          src={resolvedSrc}
+          // onLoadStart={() => {
+          //   // setStatus('loading')
+          // }}
+          onError={() => {
+            setStatus('error')
+          }}
+          onLoad={() => {
+            setStatus('loaded')
+          }}
+        />
+      </YStack>
+    )
+  }
+)
+
+AvatarImage.displayName = IMAGE_NAME
+
+/* -------------------------------------------------------------------------------------------------
+ * AvatarFallback
+ * -----------------------------------------------------------------------------------------------*/
+
+const FALLBACK_NAME = 'AvatarFallback'
+
+export const AvatarFallbackFrame = styled(YStack, {
+  name: FALLBACK_NAME,
+  position: 'absolute',
+  fullscreen: true,
+  zIndex: 0,
+})
+
+type AvatarFallbackExtraProps = {
+  delayMs?: number
+}
+type AvatarFallbackProps = GetProps<typeof AvatarFallbackFrame> & AvatarFallbackExtraProps
+
+const AvatarFallback = AvatarFallbackFrame.styleable<
+  ScopedProps<AvatarFallbackExtraProps>
+>((props, forwardedRef) => {
+  const { __scopeAvatar, delayMs, ...fallbackProps } = props
+  const context = useAvatarContext(FALLBACK_NAME, __scopeAvatar)
+  const [canRender, setCanRender] = React.useState(delayMs === undefined)
+
+  React.useEffect(() => {
+    if (delayMs !== undefined) {
+      const timerId = setTimeout(() => setCanRender(true), delayMs)
+      return () => clearTimeout(timerId)
+    }
+  }, [delayMs])
+
+  return canRender && context.imageLoadingStatus !== 'loaded' ? (
+    <AvatarFallbackFrame {...fallbackProps} ref={forwardedRef} />
+  ) : null
+})
+
+AvatarFallback.displayName = FALLBACK_NAME
+
+/* -------------------------------------------------------------------------------------------------
+ * Avatar
+ * -----------------------------------------------------------------------------------------------*/
+
+export const AvatarFrame = styled(Square, {
+  name: AVATAR_NAME,
+  position: 'relative',
+  overflow: 'hidden',
+})
+
+type AvatarProps = GetProps<typeof AvatarFrame>
+
+/**
+ * @summary A component that displays an image or a fallback icon.
+ * @see — Docs https://gui.dev/ui/avatar
+ *
+ * @example
+ * ```tsx
+ * <Avatar circular size="$10">
+ *  <Avatar.Image
+ *    aria-label="Cam"
+ *    src="https://images.unsplash.com/photo-1548142813-c348350df52b?&w=150&h=150&dpr=2&q=80"
+ *  />
+ *  <Avatar.Fallback backgroundColor="$blue10" />
+ * </Avatar>
+ * ```
+ */
+const Avatar = withStaticProperties(
+  React.forwardRef<GuiElement, AvatarProps>(
+    (props: ScopedProps<AvatarProps>, forwardedRef) => {
+      const { __scopeAvatar, size = '$true', ...avatarProps } = props
+      const [imageLoadingStatus, setImageLoadingStatus] =
+        React.useState<ImageLoadingStatus>('idle')
+      return (
+        <AvatarProvider
+          size={size}
+          scope={__scopeAvatar}
+          imageLoadingStatus={imageLoadingStatus}
+          onImageLoadingStatusChange={setImageLoadingStatus}
+        >
+          <AvatarFrame size={size} {...avatarProps} ref={forwardedRef} />
+        </AvatarProvider>
+      )
+    }
+  ),
+  {
+    Image: AvatarImage,
+    Fallback: AvatarFallback,
+  }
+)
+
+Avatar.displayName = AVATAR_NAME
+
+export { createAvatarScope, Avatar, AvatarImage, AvatarFallback }
+export type { AvatarProps, AvatarImageProps, AvatarFallbackProps }

package/src/index.ts

@@ -0,0 +1 @@
+export * from './Avatar'