@astryxdesign/native 0.7.5-canary.4bcd84f → 0.7.5-canary.51a0d3c

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 (76) hide show
  1. package/apple/Package.swift +1 -1
  2. package/apple/README.md +9 -7
  3. package/apple/Sources/Astryx/Avatar/Avatar.spec.md +210 -0
  4. package/apple/Sources/Astryx/Avatar/Avatar.swift +418 -0
  5. package/apple/Sources/Astryx/Base/BaseProps.swift +16 -0
  6. package/apple/Sources/Astryx/Card/Card.swift +95 -19
  7. package/apple/Sources/Astryx/Heading/Heading.swift +90 -19
  8. package/apple/Sources/Astryx/Icon/Icon.spec.md +12 -11
  9. package/apple/Sources/Astryx/Icon/Icon.swift +4 -3
  10. package/apple/Sources/Astryx/Text/Text.swift +89 -70
  11. package/apple/Sources/Astryx/Text/TypeStyle.swift +143 -0
  12. package/apple/Sources/Astryx/Theme/Generated/ButterTheme.swift +390 -406
  13. package/apple/Sources/Astryx/Theme/Generated/ChocolateTheme.swift +390 -406
  14. package/apple/Sources/Astryx/Theme/Generated/DefaultTheme.swift +390 -406
  15. package/apple/Sources/Astryx/Theme/Generated/GothicTheme.swift +390 -406
  16. package/apple/Sources/Astryx/Theme/Generated/MatchaTheme.swift +390 -406
  17. package/apple/Sources/Astryx/Theme/Generated/NeutralTheme.swift +390 -406
  18. package/apple/Sources/Astryx/Theme/Generated/StoneTheme.swift +390 -406
  19. package/apple/Sources/Astryx/Theme/Generated/Tokens.swift +391 -238
  20. package/apple/Sources/Astryx/Theme/Generated/Y2kTheme.swift +390 -406
  21. package/apple/Sources/Astryx/Theme/Shadow.swift +41 -0
  22. package/apple/Sources/Astryx/Theme/Theme.swift +79 -34
  23. package/apple/Sources/Astryx/Tooltip/TooltipPresenter.swift +551 -0
  24. package/apple/Sources/Astryx/Wire/AstryxNodeView.swift +77 -0
  25. package/apple/Sources/AstryxNative/Generated/AstryxNode.swift +3 -0
  26. package/apple/Sources/AstryxNative/Generated/Avatar.swift +163 -0
  27. package/apple/Sources/AstryxNative/Generated/Icon.swift +1 -0
  28. package/apple/Sources/AstryxNative/Generated/Switch.swift +2 -26
  29. package/apple/Tests/AstryxTests/AvatarTests.swift +263 -0
  30. package/apple/Tests/AstryxTests/BannerTests.swift +1 -1
  31. package/apple/Tests/AstryxTests/CardTests.swift +143 -3
  32. package/apple/Tests/AstryxTests/EnvironmentTests.swift +92 -2
  33. package/apple/Tests/AstryxTests/HeadingTests.swift +41 -13
  34. package/apple/Tests/AstryxTests/IconTests.swift +4 -3
  35. package/apple/Tests/AstryxTests/TextInputTests.swift +1 -1
  36. package/apple/Tests/AstryxTests/TextTests.swift +90 -6
  37. package/apple/Tests/AstryxTests/ThemeTests.swift +4 -10
  38. package/apple/Tests/AstryxTests/TooltipPresenterTests.swift +220 -0
  39. package/apple/Tests/AstryxTests/TwoThemeTests.swift +5 -5
  40. package/dist/components/Avatar.d.ts +10 -0
  41. package/dist/components/Avatar.d.ts.map +1 -0
  42. package/dist/components/Avatar.js +16 -0
  43. package/dist/components/Switch.d.ts.map +1 -1
  44. package/dist/components/Switch.js +13 -0
  45. package/dist/components/index.d.ts.map +1 -1
  46. package/dist/components/index.js +2 -0
  47. package/dist/contract/fromComponentDoc.d.ts +11 -1
  48. package/dist/contract/fromComponentDoc.d.ts.map +1 -1
  49. package/dist/contract/fromComponentDoc.js +15 -1
  50. package/dist/contract/generateSwift.d.ts.map +1 -1
  51. package/dist/contract/generateSwift.js +28 -0
  52. package/dist/contract/generateTypeScript.d.ts.map +1 -1
  53. package/dist/contract/generateTypeScript.js +2 -0
  54. package/dist/contract/parseDocType.d.ts +2 -2
  55. package/dist/contract/parseDocType.d.ts.map +1 -1
  56. package/dist/contract/parseDocType.js +7 -2
  57. package/dist/contract/types.d.ts +7 -0
  58. package/dist/contract/types.d.ts.map +1 -1
  59. package/dist/types/android.d.ts +21 -5
  60. package/dist/types/core.d.ts +13 -3
  61. package/dist/types/ios.d.ts +18 -5
  62. package/dist/types/macos.d.ts +18 -5
  63. package/dist/types/shared.d.ts +18 -5
  64. package/dist/types/windows.d.ts +21 -5
  65. package/package.json +3 -3
  66. package/src/components/Avatar.ts +27 -0
  67. package/src/components/Switch.ts +13 -0
  68. package/src/components/index.ts +2 -0
  69. package/src/contract/contracts.test.ts +43 -0
  70. package/src/contract/fromComponentDoc.ts +36 -2
  71. package/src/contract/generateSwift.ts +30 -0
  72. package/src/contract/generateTypeScript.ts +2 -0
  73. package/src/contract/parseDocType.test.ts +12 -0
  74. package/src/contract/parseDocType.ts +9 -2
  75. package/src/contract/types.ts +5 -0
  76. package/src/theme/swiftIOSTheme.test.ts +78 -12
@@ -28,7 +28,7 @@ let package = Package(
28
28
  dependencies: ["AstryxNative"],
29
29
  path: "Sources/Astryx",
30
30
  // Each component's spec lives beside its view (AST-093 FR1).
31
- exclude: ["Icon/Icon.spec.md"],
31
+ exclude: ["Avatar/Avatar.spec.md", "Icon/Icon.spec.md"],
32
32
  resources: [.process("Resources")]
33
33
  ),
34
34
  .testTarget(name: "AstryxNativeTests", dependencies: ["AstryxNative"], path: "Tests/AstryxNativeTests"),
package/apple/README.md CHANGED
@@ -27,6 +27,7 @@ apple/
27
27
  │ │ ├── Resources/ # core's messages per locale, generated; do not edit
28
28
  │ │ ├── Localization/
29
29
  │ │ ├── Icon/ # Icon, Icon.spec.md
30
+ │ │ ├── Avatar/ # Avatar, Avatar.spec.md
30
31
  │ │ ├── Text/ # Text
31
32
  │ │ ├── Heading/ # Heading
32
33
  │ │ ├── Button/ # Button
@@ -51,16 +52,15 @@ apple/
51
52
  that also imports SwiftUI, write `Astryx.Button` and `SwiftUI.Button`. A
52
53
  component's parameters use core's prop names
53
54
  and values (`variant: .primary`, `size: .lg`, `isLoading`), so code reads
54
- the same across web and native, with six exceptions, the interim shape
55
- AST-093 FR5 exempts until the components move onto the generated contracts:
55
+ the same across web and native. `Text`, `Heading`, and `Card` take the
56
+ generated `TextProps`, `HeadingProps`, and `CardProps`, as AST-093 FR5 asks;
57
+ the others keep four exceptions, the interim shape FR5 exempts until they move onto the generated
58
+ contracts:
56
59
  - `Button` takes `action` where core has `onClick`.
57
60
  - `Button` takes `fillsWidth` where core has `width="100%"`.
58
61
  - `Button` takes `icon` as a shared icon name (`"search"`), which the
59
62
  generated `ButtonProps` does not carry yet.
60
63
  - `TextInput` takes a `Binding` where core has `value` and `onChange`.
61
- - `Heading`'s `level` is optional where core requires it.
62
- - `Card` takes `padding` as a whole spacing step, so it cannot spell
63
- core's `0.5` and `1.5` steps.
64
64
  - **`Templates/`** holds one folder per page template, named after the
65
65
  `astryx template` id. Templates are clone-only, as on the web: you copy a
66
66
  template's folder into your app and own it from then on. They are a
@@ -99,8 +99,10 @@ size.
99
99
  Components read every color, size, and font from the `astryx` environment
100
100
  value, never from a constant of their own. `astryx.tokens` holds the theme's
101
101
  tokens in the current mode as typed members (`tokens.color.textPrimary`,
102
- `tokens.space.s4`, `tokens.font.bodySize`), so a misspelled token fails to
103
- compile. Text sizes grow with Dynamic Type. The components still read some
102
+ `tokens.space.s4`, `tokens.font.body.size`), so a misspelled token fails to
103
+ compile. Font tokens come grouped: each type style (`tokens.font.body`,
104
+ `tokens.font.heading1`) holds its `size`, `weight`, and `leading`, and
105
+ `tokens.font.family`, `.size`, and `.weight` hold the scales. Text sizes grow with Dynamic Type. The components still read some
104
106
  tokens by core's name (`astryx.color("color-accent")`); moving them onto the
105
107
  typed members comes next.
106
108
 
@@ -0,0 +1,210 @@
1
+ ---
2
+ schema_version: 3
3
+ template_version: 7
4
+ kind: component
5
+ id: component:swift/Avatar
6
+ platform_of: component:Avatar
7
+ authority: draft
8
+ archive_reason: null
9
+ superseded_by: null
10
+ approved_by: null
11
+ approved_at: null
12
+ owners: [cixzhang]
13
+ review_triggers: [public-api, behavior, layout, theming, accessibility]
14
+ verified_by:
15
+ [
16
+ packages/native/apple/Tests/AstryxTests/AvatarTests.swift,
17
+ packages/native/src/contract/contracts.test.ts,
18
+ packages/native/src/contract/parseDocType.test.ts,
19
+ ]
20
+ modules: []
21
+ families: []
22
+ design_specs: []
23
+ architecture: []
24
+ contributing: []
25
+ system_specs: [spec:AST-082, spec:AST-093]
26
+ ---
27
+
28
+ # Avatar (Swift) component contract
29
+
30
+ ## Contract at a glance
31
+
32
+ | Area | Contract |
33
+ | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
34
+ | Public contract | `Avatar(_ name: String? = nil, src:, fallbackSrc:, alt:, size: AvatarSize?, shape: AvatarShape?, tooltip: AvatarTooltip?, href:, onClick:)` and `Avatar(_ props: AvatarProps)`, a SwiftUI `View` in module `Astryx`. `size` is the named sizes `xsm` to `xl`. |
35
+ | Behavior | Draws the image at `src`, else `fallbackSrc`, else initials from `name` on the theme's neutral plate, else a person symbol, clipped to its shape. With `href` it is a SwiftUI `Link`; with only `onClick` it is a button; it draws the same either way. |
36
+ | End-user impact | A person sees the same picture, initials, and shape as on the web, and VoiceOver reads the avatar's name, or skips a decorative one. |
37
+ | Builder impact | An app passes a name and an image URL, and optionally tooltip words. Pixel sizes, `status`, `target`, and `rel` have no Swift form; an `href` must be an absolute URL. |
38
+ | Compatibility/readiness | Additive: a new view and generated `AvatarProps`. Draft; built and tested on macOS and the iOS Simulator; device captures are attached to the change. |
39
+ | Review checks | Reject a size or shape beyond the contract, a disabled state, a link or button that draws differently from the static avatar, a layout that grows for the touch target, or a static avatar VoiceOver reads without a name. |
40
+ | Governing rules | `spec:AST-082` FR3, FR4, FR7; `spec:AST-093` FR1–FR5; the Swift component API (A1–A9), theme environment, and accessibility records under `packages/native/specs/swift/library/`. |
41
+
42
+ This table is a review projection; the body below is authoritative.
43
+
44
+ ## Intent
45
+
46
+ Avatar on Apple platforms shows a person's or an entity's picture with core's
47
+ fallback order, sizes, shapes, and naming, drawn with SwiftUI's own image
48
+ loading and link and button controls.
49
+
50
+ ## Compatibility and migration
51
+
52
+ - Released default preserved: `not yet released`
53
+ - Compatibility class: additive
54
+ - Controlled/uncontrolled behavior: not applicable
55
+ - Migration decision: none
56
+
57
+ Consumer migration instructions belong in consumer docs and release notes.
58
+
59
+ ## Ownership boundary
60
+
61
+ **Owns**
62
+
63
+ - Loading `src`, then `fallbackSrc`, with SwiftUI `AsyncImage`.
64
+ - Initials, the person symbol, the plate color, and the shape clip.
65
+ - Switching to a SwiftUI `Link` or `Button` for `href` or `onClick` without
66
+ changing the drawing.
67
+ - The avatar's VoiceOver name and its touch target.
68
+
69
+ **Does not own / non-goals**
70
+
71
+ - The meaning of the props, the initials rule, and the size scale — owned by
72
+ `component:Avatar`.
73
+ - Status dots and avatar groups, which have no Swift view.
74
+
75
+ ## Public concepts
76
+
77
+ | Concept | Closed values or states | Meaning | Availability by variant/orientation/state | Default | Owner | Stability | Invalid-value behavior |
78
+ | ------- | ---------------------------------------------- | --------------------------------------------------- | ----------------------------------------- | -------- | ------------------------ | ------------ | -------------------------------------------------------------------------- |
79
+ | size | `xsm`, `sm`, `md`, `lg`, `xl` | 20, 24, 36, 48, 128 points at the default text size | always | `md` | `component:Avatar` | experimental | core's pixel sizes have no Swift form |
80
+ | shape | `circle`, `rounded`, `square` | full round, the theme's element radius, no radius | always | `circle` | `component:Avatar` | experimental | none |
81
+ | picture | image, fallback image, initials, person symbol | the first that is available, in that order | always | — | `component:Avatar` | experimental | an empty or unloadable URL moves to the next |
82
+ | control | static, link (`href`), button (`onClick`) | how a tap behaves; the drawing is the same | always | static | `component:swift/Avatar` | experimental | an `href` that is not an absolute URL leaves the avatar static or a button |
83
+
84
+ ## Behavioral and layout contract
85
+
86
+ | ID | Candidate invariant | Basis | Draft review state |
87
+ | --- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------- | ------------------ |
88
+ | FR1 | The view MUST show the image at `src`; when it is absent or fails, the image at `fallbackSrc`; then initials from a `name` that is not blank; then a person symbol. The fallback image loads only after `src` fails or when there is no `src`; while an image loads, the initials or the person symbol show. | core `Avatar` fallback order; `spec:AST-093` FR2 | verify |
89
+ | FR2 | Initials MUST follow core's rule: the first letter, digit, or emoji of the first and last words that have one, uppercased, skipping leading punctuation, keeping a whole emoji, flag, or joined emoji sequence. A name with none shows the person symbol and still names the avatar. | core `Avatar` initials | verify |
90
+ | FR3 | The avatar MUST be a square of 20, 24, 36, 48, or 128 points for `xsm` to `xl` at the default text size, grown with Dynamic Type up to 1.6 times and never shrunk, so it and its initials grow with the name beside them without swallowing a row (`spec:AST-082` FR11). It is clipped to a circle, to the theme's `radius.element`, or to a square. | core `Avatar` sizes and shapes | verify |
91
+ | FR4 | Initials and the person symbol MUST draw in `color.textSecondary` on `color.neutral`; initials use the theme's body family at medium weight and 40% of the side. | core `Avatar` fallback styles; `spec:AST-093` FR4 | verify |
92
+ | FR5 | With an `href` that is an absolute URL (it has a scheme), the avatar MUST be a SwiftUI `Link`; with `onClick` too, `onClick` runs as it opens and the URL then goes to the app's own URL handler, or the system's. An `href` that is not an absolute URL, such as a web path, MUST stop a development build with a message naming it; a release build draws the avatar without a link, as a button with `onClick` or static. With only `onClick`, a SwiftUI `Button`. Either draws exactly as the static avatar, and the avatar has no disabled state. | Swift component API A4 | verify |
93
+ | FR6 | Both initializers MUST build the same `AvatarProps`; `name` is the unlabeled first parameter and `onClick` the last, so it can be a trailing closure. Base props come through `AvatarProps`: with `isHidden` the view draws nothing; `id` becomes the accessibility identifier. | Swift component API A2–A4, A7; `spec:AST-082` FR7 | verify |
94
+ | FR8 | `tooltip` MUST resolve, as core does, to the name for `nil` or `true`, the given words for a string, and nothing for `false` or blank words, and MUST show through the Astryx tooltip (`architecture:native-swift-library-tooltip`), with the focus and touch the Tooltip by input table below states: a static avatar is a tab stop and opens on a tap; a link or button keeps its focus and its tap. Given words are the VoiceOver hint. On the wire it is the web value, a string or a Bool. | core `Avatar` `tooltip`; core `Tooltip`; `spec:AST-082` FR3 | verify |
95
+
96
+ **Tooltip by input (FR8).** The Astryx tooltip's rules apply; this table
97
+ states Avatar's choices.
98
+
99
+ | Input | Default name | Given words | Off (`false` or blank) |
100
+ | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------ |
101
+ | Pointer | the bubble shows the name above the avatar after 200 ms, stays while the pointer is on it, and a press hides it | the same, with the words | nothing |
102
+ | Keyboard focus | the bubble shows the name at once and Escape hides it; a static avatar is a tab stop | the same, with the words | nothing; a static avatar is not a tab stop |
103
+ | Touch tap | a direct tap on a static avatar opens the bubble with the name; another tap on it, or a tap anywhere else, closes it, and that tap still reaches what it lands on; the tap is shared with an enclosing row; a link or button keeps its tap | the same, with the words | nothing |
104
+ | VoiceOver | the name is read once, as the avatar's own; the bubble is hidden and the tap is left alone | the words are the hint, as core puts them in the description | nothing |
105
+
106
+ ### Allowed variation
107
+
108
+ - **AV1 — Loading.** While an image loads, the initials or the person symbol
109
+ show instead of an empty plate.
110
+ - **AV2 — Glyph.** The person symbol is the SF Symbol `person.fill`, not core's
111
+ SVG.
112
+
113
+ - **AV3 — Tooltip surface.** The tooltip is the Astryx tooltip's bubble in
114
+ core's tooltip colors on every input. SwiftUI's `.help` does not fit: it is
115
+ also the VoiceOver hint, so it would read the name twice, and it shows with
116
+ the system's look and delay, never on keyboard focus or a tap.
117
+
118
+ ### Representative states
119
+
120
+ | State | Required invariant | Allowed variation |
121
+ | ------------------------------ | -------------------------------------- | ----------------- |
122
+ | image | the image fills the shape | image content |
123
+ | failed image with a fallback | the fallback image | none |
124
+ | initials, every size and shape | initials centered on the neutral plate | glyph metrics |
125
+ | no name | the person symbol at 60% of the side | none |
126
+ | link and button | the same drawing as static | none |
127
+ | light and dark, two themes | each theme's plate and text color | none |
128
+
129
+ ### Transformation and precedence order
130
+
131
+ - **ORD1 — Picture.** `src` → `fallbackSrc` → initials → person symbol.
132
+ - **ORD2 — Name.** `alt` → `name` → none, where a blank string is none.
133
+ - **ORD3 — Control.** `href` (link) → `onClick` (button) → static.
134
+
135
+ ### Performance and resources
136
+
137
+ - **PR1 — System loading.** Images load through `AsyncImage` and the system
138
+ URL cache; the view keeps no image cache of its own.
139
+
140
+ ## Accessibility contract
141
+
142
+ - **AR1 — Named or decorative.** A static avatar with a name is one image
143
+ element named by `alt`, else `name`; without one it is hidden from VoiceOver.
144
+ A link or button avatar is one element with the link or button trait and the
145
+ same name; the initials are never an element of their own (Swift
146
+ accessibility X1, X5).
147
+ - **AR2 — Touch target.** A link or button avatar, and a static avatar whose
148
+ tap opens its tooltip, answers taps across at least 44 by 44 points without
149
+ changing its drawn size or layout (X7).
150
+ - **AR3 — Rendered tree not measured.** Tests assert what the view sets; the
151
+ rendered accessibility tree and the hit region are not measured until an
152
+ app-hosted target exists.
153
+ - **AR4 — Unnamed taps are flagged.** A link or button avatar without `alt`
154
+ or `name` logs a development warning, as core warns.
155
+ - **AR5 — Initials contrast.** The initials draw in core's tokens,
156
+ `color.textSecondary` on `color.neutral`, as core's Avatar does. In the
157
+ default and neutral themes' dark appearance that pair is below 4.5:1, in
158
+ core as well; the fix belongs to the theme tokens.
159
+
160
+ ## Design relationships
161
+
162
+ | Anatomy or state | Design requirement | Representation authority | Hierarchy role | Component contract |
163
+ | ---------------- | ---------------------------------------- | ------------------------ | -------------- | ------------------ |
164
+ | Photo, initials | Apple Human Interface Guidelines, Images | prescribed by core | prominent | FR1–FR4 |
165
+
166
+ The component implements design requirements without copying their rationale.
167
+
168
+ Platform controls: SwiftUI `AsyncImage` for the images, SwiftUI `Link` for
169
+ `href`, and SwiftUI `Button` for `onClick` (`spec:AST-093` FR2). SwiftUI has no
170
+ avatar control, so the plate, initials, and clip are drawn here. Guideline
171
+ pages: Images, Buttons, and Accessibility in the Apple Human Interface
172
+ Guidelines.
173
+
174
+ Theme values read: `color.neutral`, `color.textSecondary`, `radius.element`,
175
+ `font.family.body`, `font.weight.medium`, and Bold Text; for the tooltip bubble,
176
+ `color.textPrimary`, `color.backgroundSurface`, `space.s1`, `space.s2`,
177
+ `radius.container`, and the body text size and weight.
178
+
179
+ ## Family and system relationships
180
+
181
+ - `component:Avatar` owns the props, the sizes, the initials rule, and the
182
+ fallback order; this record states only how Swift draws them.
183
+ - An owner that holds an Avatar in a slot leaves an unsized Avatar at `md`
184
+ (Swift slots S4).
185
+
186
+ ## Verification map
187
+
188
+ | Contract | Verification | Representative states | Mutation or failure expectation | Audit section |
189
+ | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------- |
190
+ | FR1, FR2 | `AvatarTests.swift` initials and fallback tests | core's initials cases; blank and symbol names | a wrong initial or a missing person symbol fails | `audit:swift/Avatar/picture` |
191
+ | FR3, FR4 | `AvatarTests.swift` size, text-size growth, shape, and two-theme renders | each size; xx-large and the largest text size; circle and square; light, dark, butter | a wrong side, no growth or growth past 1.6 times, an unclipped corner, or a color of its own fails | `audit:swift/Avatar/look` |
192
+ | FR5, AR2, AR4 | `AvatarTests.swift` link and button renders; tap, trait, tap-area, warning, `linkURL`, and web-path tests | static, link, button; malformed, relative, and empty `href` | a link or button that draws differently, a malformed `href` made a link, a web path not flagged, or an unflagged unnamed tap fails | `audit:swift/Avatar/control` |
193
+ | FR8 | `AvatarTests.swift` tooltip words, focus and touch, VoiceOver hint, and wire tests; `TooltipPresenterTests.swift` for each input; `contracts.test.ts`; `parseDocType.test.ts` | name, `true`, words, `false`, blank, no name; static, link, button | a wrong tooltip, a static avatar that is not a tab stop or does not open on a tap, a control that loses its tap, or a wire value that is not the web's fails | `audit:swift/Avatar/tooltip` |
194
+ | FR6 | `AvatarTests.swift` initializer and hidden tests; `contracts.test.ts` | both initializers; `isHidden`; named sizes | differing props, a drawn hidden avatar, or a pixel size in Swift fails | `audit:swift/Avatar/api` |
195
+ | AR1 | `AvatarTests.swift` naming and trait tests | `alt`, `name`, blank, none | a wrong name or a named decorative avatar fails | `audit:swift/Avatar/a11y` |
196
+ | AR5 | `AvatarTests.swift` two-theme renders draw the initials in core's tokens | default and neutral, light and dark | initials in tokens other than core's fail | `audit:swift/Avatar/look` |
197
+
198
+ ## Decision log
199
+
200
+ No component-local decision is recorded.
201
+
202
+ ## Open questions
203
+
204
+ - **OQ2 — Status dots.** (`human-api`) `status` holds `AvatarStatusDot`, which
205
+ has no Swift view, so it stays on the web until one exists.
206
+
207
+ ## Content boundary
208
+
209
+ This file does not duplicate consumer prop tables/examples, current audit
210
+ results, implementation steps, or family/system rules. It links to their owners.