j3w1/theme implementation brief — avatar
theme: j3w1-theme 1.1.0  profile: default  sourceDigest: sha256-C+iD5Q7l0XPU/boMj003wPbPLBOq3C3ZM7s4OfzJ6mc=
pin: https://raw.githubusercontent.com/j3w1/theme/v1.1.0/exports/components/avatar.json
spec: spec/components/avatar.md  site: https://j3w1.github.io/theme/reference/#c-avatar
maturity: stable  priority: R2

Summary: A square entity image with a named text fallback.

Use the pinned approved default profile. Pending roles in that profile use-and-report their decision IDs; this does not approve them. Proposed profiles are preview-only and blocked for delivery. Heritage profiles are historical-only. Deprecated or heritage roles are blocked for new approved-profile mappings. Consume roles within their documented scope, never primitives. Release numbering does not approve profiles or tokens.
Tokens (resolved):
  root.bg                               #100c0c  ({color.surface.default})  use
  root.text                             #e99499  ({color.text.default})  use
  root.border                           #a3676b  ({color.border.control})  use-and-report (D-007)
  heading.text                          #ffa2a7  ({color.text.bright})  use
  secondary.text                        #bd787d  ({color.text.muted})  use
  control.bg                            #000000  ({color.surface.input})  use
  control.focus                         #e53935  ({color.interaction.focus.ring})  use
  dependency.role-border-width-default  1px  ({border.width.default})  use
  dependency.role-font-weight-bold      700  ({font.weight.bold})  use
  dependency.role-radius-none           0px  ({radius.none})  use
  dependency.role-space-12              12px  ({space.12})  use
  dependency.role-space-2               2px  ({space.2})  use
  dependency.role-space-32              32px  ({space.32})  use
State dependency disclosures: D-007

States: default, loading, error
  default: Initials or loaded image. [Full name on the image container.]
  loading: Fallback remains visible. [No loss of the full accessible name while loading.]
  error: Fallback remains visible. [Image failure does not remove the entity name.]

Keyboard:
  Tab: No additional tab stop. An enclosing link remains native.

ARIA: Named image or text fallback
Responsive: Wrap labels and actions without changing source order. Use logical spacing in RTL. Preserve native target sizes at both densities; only bounded data regions may scroll horizontally.
Portability: Identify a person or entity with an optional caller-owned image and text fallback. The component ships no image service or assets. Failed images restore the fallback and retain the full accessible name.
  native: Use equivalent native semantics and approved roles; record any unsupported behavior as a mapping deviation.

Rules: use only these values; no invented colours; radius 0; borders 1px (2px emphasis); focus is a 1px dashed ring, selection is a fill;
do not restyle unrelated elements; report deviations per agents/consume.md; record theme.lock.json at the pinned revision.