@jobber/components-native 0.115.2-codexjob--9905233.7 → 0.115.3

package/dist/types/src/ActivityIndicator/ActivityIndicator.d.ts

@@ -42,7 +42,7 @@ export interface ActivityIndicatorProps {
  * Renders the Material Design 3 three-layer indeterminate ring,
  * matching the visual identity of the web `ActivityIndicator` from
  * `@jobber/components`. For determinate progress, use
- * `ProgressIndicator` (forthcoming).
+ * `ProgressIndicator`.
  */
 export declare function ActivityIndicator({ size, accessibilityLabel, style, testID, }: ActivityIndicatorProps): React.JSX.Element;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jobber/components-native",
-  "version": "0.115.2-codexjob--9905233.7+9905233c",
+  "version": "0.115.3",
   "license": "MIT",
   "description": "React Native implementation of Atlantis",
   "repository": {
@@ -123,5 +123,5 @@
     "react-native-screens": ">=4.18.0",
     "react-native-svg": ">=12.0.0"
   },
-  "gitHead": "9905233c18ce012134f57ba140fabba5225e18a6"
+  "gitHead": "b499bb6c3219b55c6de2614a8d83b44a4800980b"
 }

package/src/ActivityIndicator/ActivityIndicator.tsx

@@ -130,7 +130,7 @@ function useAnnounceOnMount(label: string) {
  * Renders the Material Design 3 three-layer indeterminate ring,
  * matching the visual identity of the web `ActivityIndicator` from
  * `@jobber/components`. For determinate progress, use
- * `ProgressIndicator` (forthcoming).
+ * `ProgressIndicator`.
  */
 export function ActivityIndicator({
   size = "base",
@@ -276,7 +276,7 @@ function FullMotionRing({
 
   const arcAnimatedProps = useAnimatedProps(() => {
     "worklet";
-    // Match web's indicatorExpandArc keyframe:
+    // Follow the original Material indicator arc progression:
     //   0%   → dasharray (1, 200),  offset 0
     //   50%  → dasharray (90, 200), offset -35
     //   100% → dasharray (90, 200), offset -125
@@ -390,8 +390,8 @@ function ReducedMotionRing({
 }: ReducedMotionRingProps) {
   // Reduced motion: hide rotation entirely, render one static ring in the
   // active foreground colour, and pulse opacity 1.0 ↔ 0.35 over a 4s
-  // ease-in-out alternate cycle (2s down, 2s up). Matches web's
-  // reduced-motion fallback exactly.
+  // ease-in-out alternate cycle (2s down, 2s up). This matches the web
+  // reduced-motion fallback's presentation and rhythm.
   //
   // CRITICAL: Reanimated 3 automatically suppresses `withTiming` /
   // `withRepeat` when the OS reduce-motion setting is enabled, snapping

package/src/ActivityIndicator/guide.md

@@ -6,22 +6,21 @@
 directly control or measure — loading, fetching, or waiting on an external
 system. It is a non-interactive Atom in `@jobber/components-native`.
 
-This component is the mobile counterpart of the web `ActivityIndicator` shipped
-in atlantis change `add-activityindicator`. Both components render the Material
-Design 3 three-layer indeterminate ring, with the same sizes, motion durations,
-color tokens, and reduced-motion fallback. Public prop names diverge to follow
-each platform's native conventions (`accessibilityLabel` here vs. `ariaLabel` on
-web; `style` here vs. `className` + `style` on web).
+This component is the mobile counterpart of the web `ActivityIndicator`. Both
+components render the same indeterminate-ring visual language and share semantic
+color tokens, simplified small-size motion, and a reduced-motion fallback.
+Sizes, base motion timings, and public prop names intentionally follow each
+platform's needs.
 
 This is one half of the paired Indicators system described in
-`docs/component_upgrades/Indicators.proposal.md`. The other half,
-`ProgressIndicator`, will own determinate-controlled cases (progress with a
-known fraction) on both platforms and is forthcoming.
+`docs/component_upgrades/Indicators.proposal.md`. Use `ProgressIndicator` for
+determinate cases where the completed fraction is known.
 
 The change that introduced this component (motivation, decisions, alternatives
-considered) is recorded in `openspec/changes/add-activityindicator-mobile/`. The
-web spec is at
-`packages/components/src/ActivityIndicator/ActivityIndicator.spec.md`.
+considered) is recorded in
+`openspec/changes/archive/2026-06-10-add-activityindicator-mobile/`. The current
+web contract is in `openspec/specs/activity-indicator/spec.md`, with additional
+implementation guidance in `packages/components/src/ActivityIndicator/guide.md`.
 
 ## API
 
@@ -61,7 +60,7 @@ spread. The new public API drops the following intentionally:
 - Other React Native `View` / `ActivityIndicatorProps` pass-throughs — `style`
   and `testID` are the two preserved escape hatches.
 
-### Deprecated alias (this release only)
+### Deprecated alias
 
 `size` accepts `"large"` as a deprecated alias for `"base"`. The TypeScript type
 unions `"small" | "base" | "large"`; the `"large"` branch carries a JSDoc
@@ -96,8 +95,8 @@ double-announce on mount. The imperative call is uniform across iOS and Android;
 the live region is platform-specific. Dropping the latter keeps the rendering
 path free of `Platform.OS` branches.
 
-The indicator is not focusable and is not in the keyboard / screen reader
-navigation order beyond the initial announcement.
+The indicator is non-interactive. It exposes one accessible progress element and
+does not require keyboard or screen-reader interaction.
 
 ## Animation Model
 
@@ -148,13 +147,14 @@ entry rather than nested `isSmall` / `isLarge` branches.
 - The 8-phase inner rotation and expand/contract arc are omitted because that
   layered motion reads as too busy at 28px.
 
-This keeps FormatFile grid thumbnails and other small call sites visually
-aligned with web's small indicator, not just size-matched.
+This keeps FormatFile grid thumbnails and other small call sites behaviorally
+aligned with web's small indicator while retaining mobile-appropriate sizing.
 
-The literal base durations match Material Web's published progress motion spec;
-the same values ship from `@jobber/design`'s `timing.tokens.json` to both web
-and mobile so the base rhythm is identical across platforms. The small spin
-duration is a CSS literal on web and a matching constant on native (`1000ms`).
+The native base durations match Material Web's published progress motion spec
+and are provided by `@jobber/design`'s `timing-indicator-*` tokens. Web scales
+those timings by 1.15× for a calmer desktop rhythm, so the base motion is
+deliberately similar rather than identical. The small spin duration is `1000ms`
+on both platforms.
 
 ## Reduced Motion
 
@@ -187,10 +187,10 @@ shipped — the original 0.55 lower bound was too subtle to read as activity.
 | `small` | 28 px          | proportional to web's small variant | Layer 1 only; fixed arc; 1000ms spin         |
 | `base`  | 44 px          | proportional to web's base variant  | Full three-layer Material indeterminate ring |
 
-Sizes are unified across iOS, Android, and web. The component deliberately does
-not adopt iOS-native sizing (`UIActivityIndicatorView`'s ~20/~37 px) — the
-cross-platform parity argument wins over Apple HIG convention here, consistent
-with the "one implementation, no platform branch" stance.
+Sizes are unified across iOS and Android. Mobile deliberately uses larger
+dimensions than web (28/44px here versus 16/32px on web) and does not adopt
+iOS-native sizing (`UIActivityIndicatorView`'s ~20/~37 px). The implementation
+still avoids platform-specific rendering branches.
 
 Layout — inline-vs-block placement, margins, alignment — is the consumer's
 responsibility. The component has no `inline` prop. Wrap in a `<View>`,
@@ -198,23 +198,23 @@ responsibility. The component has no `inline` prop. Wrap in a `<View>`,
 
 ## Cross-platform parity
 
-Visual + behavioral parity with the web `ActivityIndicator` is the primary goal.
-Both components share:
+Visual and behavioral consistency with the web `ActivityIndicator` is the
+primary goal. Both components share:
 
 - Material Design 3 three-layer indeterminate ring geometry
-- Sizes (28 px small, 44 px base)
-- Motion durations (`timing-indicator-arc`, `timing-indicator-cycle`,
-  `timing-indicator-linear-rotate`) from the same `@jobber/design` source
 - Color tokens (`color-text--secondary` for arcs, `color-surface--active` for
   track) from the same `@jobber/design` source
 - Reduced-motion fallback (opacity 1.0 ↔ 0.35, 2 s ease-in-out alternate)
+- Layer 1-only motion for the small size, with a 1000ms spin
 
 Documented divergences:
 
 | Aspect                   | Web                                                                          | Mobile                                                                                                                   |
 | ------------------------ | ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
+| Sizes                    | 16px small, 32px base                                                        | 28px small, 44px base                                                                                                    |
+| Base motion              | Tuned 1803 / 6132 / 1533ms CSS literals                                      | Material 1568 / 5332 / 1333ms `timing-indicator-*` tokens                                                                |
 | Accessible label         | `ariaLabel`                                                                  | `accessibilityLabel`                                                                                                     |
-| Default label            | hardcoded `"Loading"`                                                        | `useAtlantisI18n("loading")`                                                                                             |
+| Default label            | `useAtlantisI18n(commonMessages)`                                            | `useAtlantisI18n("loading")`                                                                                             |
 | Styling                  | `className` + `style`                                                        | `style`                                                                                                                  |
 | Test id                  | (no equivalent; tests use `getByRole` / `getByText`)                         | `testID`                                                                                                                 |
 | Accessibility plumbing   | `role="status"` + visually-hidden text + announce-on-mount fix for VoiceOver | `accessibilityRole="progressbar"` + `accessibilityState={{ busy: true }}` + `AccessibilityInfo.announceForAccessibility` |
@@ -232,8 +232,8 @@ wrapper around React Native's primitive. Migration of existing call sites:
 - Bare `<ActivityIndicator />` — no change needed. The new component renders a
   (better-looking) Material ring at the base size.
 - `<ActivityIndicator size="small" />` — no change needed.
-- `<ActivityIndicator size="large" />` — runs unchanged for this release; warns
-  in development. Update to `size="base"` at your convenience.
+- `<ActivityIndicator size="large" />` — remains available during the migration
+  window and warns in development. Update to `size="base"` at your convenience.
 - `<ActivityIndicator color="white" />` — no longer supported. The single known
   site (`jobber-mobile/GalleryHeader`) is migrated by the
   `migrate-activityindicator` change in the jobber-mobile repository.