@shaykec/app-agent 1.0.9 → 1.0.10

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 (199) hide show
  1. package/.claude/agents/catalog-analyzer.md +57 -0
  2. package/.claude/skills/android-customizer/SKILL.md +23 -10
  3. package/.claude/skills/bug-fixer/SKILL.md +59 -0
  4. package/.claude/skills/catalog-analyzer/SKILL.md +96 -0
  5. package/.claude/skills/customization-planner/SKILL.md +44 -5
  6. package/.claude/skills/design-selector/SKILL.md +3 -1
  7. package/.claude/skills/design-system/SKILL.md +1 -1
  8. package/.claude/skills/exploratory-tester/SKILL.md +82 -0
  9. package/.claude/skills/ios-customizer/SKILL.md +29 -8
  10. package/.claude/skills/module-integrator/SKILL.md +1 -1
  11. package/.claude/skills/react-native-customizer/SKILL.md +22 -10
  12. package/.claude/skills/test-planner/SKILL.md +72 -0
  13. package/.cursor/agents/README.md +3 -1
  14. package/.cursor/agents/catalog-analyzer.md +83 -0
  15. package/.cursor/rules/safety-guardrails.mdc +1 -1
  16. package/.cursor/rules/workflow.mdc +52 -18
  17. package/.cursor/skills/android-customizer/SKILL.md +43 -19
  18. package/.cursor/skills/bug-fixer/SKILL.md +189 -0
  19. package/.cursor/skills/catalog-analyzer/SKILL.md +222 -0
  20. package/.cursor/skills/customization-planner/SKILL.md +55 -8
  21. package/.cursor/skills/design-selector/SKILL.md +6 -5
  22. package/.cursor/skills/design-system/SKILL.md +8 -7
  23. package/.cursor/skills/exploratory-tester/SKILL.md +223 -0
  24. package/.cursor/skills/ios-customizer/SKILL.md +47 -12
  25. package/.cursor/skills/module-integrator/SKILL.md +2 -2
  26. package/.cursor/skills/output-validator/SKILL.md +1 -1
  27. package/.cursor/skills/react-native-customizer/SKILL.md +46 -16
  28. package/.cursor/skills/test-planner/SKILL.md +199 -0
  29. package/AGENTS.md +32 -11
  30. package/CLAUDE.md +78 -33
  31. package/README.md +77 -11
  32. package/designs/DESIGN_CATALOG.md +17 -15
  33. package/designs/DESIGN_PRINCIPLES.md +53 -0
  34. package/designs/brands/accessible-high-contrast.md +14 -0
  35. package/designs/brands/corporate-professional.md +14 -0
  36. package/designs/brands/dark-luxe.md +14 -0
  37. package/designs/brands/kids-playful.md +14 -0
  38. package/designs/brands/medical-clinical.md +14 -0
  39. package/designs/brands/modern-minimal.md +14 -0
  40. package/designs/brands/nature-organic.md +14 -0
  41. package/designs/brands/neo-brutalist.md +14 -0
  42. package/designs/brands/retro-vintage.md +14 -0
  43. package/designs/brands/soft-gradient.md +14 -0
  44. package/designs/brands/sport-athletic.md +14 -0
  45. package/designs/brands/tech-dynamic.md +14 -0
  46. package/designs/brands/vibrant-playful.md +14 -0
  47. package/dist/cli.d.ts +4 -2
  48. package/dist/cli.d.ts.map +1 -1
  49. package/dist/cli.js +91 -1
  50. package/dist/cli.js.map +1 -1
  51. package/dist/config.d.ts +2 -0
  52. package/dist/config.d.ts.map +1 -1
  53. package/dist/config.js +2 -0
  54. package/dist/config.js.map +1 -1
  55. package/dist/engines/claude-engine.d.ts.map +1 -1
  56. package/dist/engines/claude-engine.js +16 -4
  57. package/dist/engines/claude-engine.js.map +1 -1
  58. package/dist/engines/types.d.ts +1 -1
  59. package/dist/engines/types.d.ts.map +1 -1
  60. package/dist/engines/types.js +31 -2
  61. package/dist/engines/types.js.map +1 -1
  62. package/dist/github.d.ts +3 -0
  63. package/dist/github.d.ts.map +1 -1
  64. package/dist/github.js +47 -4
  65. package/dist/github.js.map +1 -1
  66. package/dist/index.js +217 -9
  67. package/dist/index.js.map +1 -1
  68. package/dist/prompt-builder.d.ts +11 -1
  69. package/dist/prompt-builder.d.ts.map +1 -1
  70. package/dist/prompt-builder.js +216 -1
  71. package/dist/prompt-builder.js.map +1 -1
  72. package/dist/validator.d.ts +7 -2
  73. package/dist/validator.d.ts.map +1 -1
  74. package/dist/validator.js +61 -41
  75. package/dist/validator.js.map +1 -1
  76. package/dist/workspace.js +2 -2
  77. package/dist/workspace.js.map +1 -1
  78. package/package.json +2 -2
  79. package/prompts/agent-prompt.md +35 -18
  80. package/prompts/deep-test-agent-prompt.md +122 -0
  81. package/prompts/fix-agent-prompt.md +90 -0
  82. package/prompts/quick-agent-prompt.md +32 -2
  83. package/prompts/scratch-agent-prompt.md +5 -8
  84. package/templates/android/BookTemplate/app/src/main/kotlin/com/appship/book/core/animation/AnimatedTransitionsModifiers.kt +188 -0
  85. package/templates/android/ChatTemplate/app/src/main/kotlin/com/appship/chat/core/animation/AnimatedTransitionsModifiers.kt +188 -0
  86. package/templates/android/ChatTemplate/app/src/main/kotlin/com/appship/chat/features/conversations/ConversationsScreen.kt +1 -1
  87. package/templates/android/DashTemplate/app/src/main/kotlin/com/appship/dash/core/animation/AnimatedTransitionsModifiers.kt +188 -0
  88. package/templates/android/DashTemplate/app/src/main/kotlin/com/appship/dash/features/navigation/MainScreen.kt +1 -0
  89. package/templates/android/FamilyTemplate/app/src/main/java/com/appship/family/core/animation/AnimatedTransitionsModifiers.kt +188 -0
  90. package/templates/android/FamilyTemplate/app/src/main/java/com/appship/family/features/navigation/MainNavigation.kt +5 -1
  91. package/templates/android/FinanceTemplate/app/src/main/kotlin/com/appship/finance/core/animation/AnimatedTransitionsModifiers.kt +188 -0
  92. package/templates/android/GameTemplate/app/src/main/kotlin/com/appship/game/core/animation/AnimatedTransitionsModifiers.kt +188 -0
  93. package/templates/android/GameTemplate/app/src/main/kotlin/com/appship/game/core/animation/MotionPreferencesScreen.kt +3 -3
  94. package/templates/android/GameTemplate/app/src/main/kotlin/com/appship/game/features/navigation/Navigation.kt +1 -1
  95. package/templates/android/GameTemplate/app/src/main/kotlin/com/appship/game/features/settings/SettingsScreen.kt +1 -1
  96. package/templates/android/HealthTemplate/app/src/main/kotlin/com/appship/health/core/animation/AnimatedTransitionsModifiers.kt +188 -0
  97. package/templates/android/LearnTemplate/app/src/main/kotlin/com/appship/learn/core/animation/AnimatedTransitionsModifiers.kt +188 -0
  98. package/templates/android/MapTemplate/app/src/main/kotlin/com/appship/map/core/animation/AnimatedTransitionsModifiers.kt +188 -0
  99. package/templates/android/MediaTemplate/app/src/main/kotlin/com/appship/media/core/animation/AnimatedTransitionsModifiers.kt +188 -0
  100. package/templates/android/MediaTemplate/app/src/main/kotlin/com/appship/media/features/settings/SettingsScreen.kt +3 -2
  101. package/templates/android/ReferenceTemplate/app/src/main/kotlin/com/appship/reference/core/animation/AnimatedTransitionsModifiers.kt +188 -0
  102. package/templates/android/ReferenceTemplate/app/src/main/kotlin/com/appship/reference/features/settings/SettingsScreen.kt +1 -1
  103. package/templates/android/ShopTemplate/app/src/main/kotlin/com/appship/shop/core/animation/AnimatedTransitionsModifiers.kt +188 -0
  104. package/templates/android/ShopTemplate/app/src/main/kotlin/com/appship/shop/features/cart/CartScreen.kt +3 -2
  105. package/templates/android/Skeleton/app/src/main/kotlin/com/appship/skeleton/core/animation/AnimatedTransitionsModifiers.kt +188 -0
  106. package/templates/android/Skeleton/tests/03_detail_screen.yaml +1 -1
  107. package/templates/android/Skeleton/tests/04_favorites.yaml +1 -1
  108. package/templates/android/Skeleton/tests/08_full_e2e.yaml +7 -1
  109. package/templates/android/SocialTemplate/app/src/main/kotlin/com/appship/social/core/animation/AnimatedTransitionsModifiers.kt +188 -0
  110. package/templates/android/TaskTemplate/app/src/main/kotlin/com/appship/task/core/animation/AnimatedTransitionsModifiers.kt +188 -0
  111. package/templates/android/TaskTemplate/app/src/main/kotlin/com/appship/task/features/settings/SettingsScreen.kt +3 -2
  112. package/templates/android/TrackTemplate/app/src/main/kotlin/com/appship/track/core/animation/AnimatedTransitionsModifiers.kt +188 -0
  113. package/templates/ios/BookTemplate/BookTemplate/Core/Animation/AnimatedTransitionsView.swift +201 -0
  114. package/templates/ios/ChatTemplate/ChatTemplate/Core/Animation/AnimatedTransitionsView.swift +201 -0
  115. package/templates/ios/DashTemplate/DashTemplate/App/AppConfig.swift +1 -0
  116. package/templates/ios/DashTemplate/DashTemplate/Core/Animation/AnimatedTransitionsView.swift +201 -0
  117. package/templates/ios/DashTemplate/DashTemplate/Core/Strings.swift +13 -0
  118. package/templates/ios/DashTemplate/DashTemplate.xcodeproj/project.pbxproj +32 -20
  119. package/templates/ios/FamilyTemplate/FamilyTemplate/Core/Animation/AnimatedTransitionsView.swift +201 -0
  120. package/templates/ios/FinanceTemplate/FinanceTemplate/Core/Animation/AnimatedTransitionsView.swift +201 -0
  121. package/templates/ios/FinanceTemplate/FinanceTemplate/Core/Strings.swift +42 -0
  122. package/templates/ios/FinanceTemplate/FinanceTemplate.xcodeproj/project.pbxproj +36 -30
  123. package/templates/ios/GameTemplate/GameTemplate/Core/Animation/AnimatedTransitionsView.swift +201 -0
  124. package/templates/ios/HealthTemplate/HealthTemplate/Core/Animation/AnimatedTransitionsView.swift +201 -0
  125. package/templates/ios/LearnTemplate/LearnTemplate/Core/Animation/AnimatedTransitionsView.swift +201 -0
  126. package/templates/ios/MapTemplate/MapTemplate/Core/Animation/AnimatedTransitionsView.swift +201 -0
  127. package/templates/ios/MediaTemplate/MediaTemplate/Core/Animation/AnimatedTransitionsView.swift +201 -0
  128. package/templates/ios/ReferenceTemplate/ReferenceTemplate/Core/Animation/AnimatedTransitionsView.swift +201 -0
  129. package/templates/ios/ReferenceTemplate/ReferenceTemplate/Core/Strings.swift +12 -0
  130. package/templates/ios/ReferenceTemplate/ReferenceTemplate/Features/SkeletonLoading/SkeletonLoadingView.swift +2 -37
  131. package/templates/ios/ShopTemplate/ShopTemplate/Core/Animation/AnimatedTransitionsView.swift +201 -0
  132. package/templates/ios/Skeleton/Skeleton/Core/Animation/AnimatedTransitionsView.swift +201 -0
  133. package/templates/ios/Skeleton/tests/08_full_e2e.yaml +4 -0
  134. package/templates/ios/SocialTemplate/SocialTemplate/Core/Animation/AnimatedTransitionsView.swift +201 -0
  135. package/templates/ios/TaskTemplate/TaskTemplate/Core/Animation/AnimatedTransitionsView.swift +201 -0
  136. package/templates/ios/TrackTemplate/TrackTemplate/Core/Animation/AnimatedTransitionsView.swift +201 -0
  137. package/templates/react-native/BookTemplate/src/animation/useAnimatedList.ts +219 -2
  138. package/templates/react-native/BookTemplate/src/animation/useMotionPreferences.ts +23 -9
  139. package/templates/react-native/BookTemplate/src/screens/Profile/ProfileScreen.tsx +1 -1
  140. package/templates/react-native/ChatTemplate/src/animation/useAnimatedList.ts +219 -2
  141. package/templates/react-native/ChatTemplate/src/animation/useMotionPreferences.ts +23 -9
  142. package/templates/react-native/ChatTemplate/src/screens/Profile/ProfileScreen.tsx +1 -1
  143. package/templates/react-native/DashTemplate/src/animation/useAnimatedList.ts +219 -2
  144. package/templates/react-native/DashTemplate/src/animation/useMotionPreferences.ts +23 -9
  145. package/templates/react-native/DashTemplate/src/screens/Profile/ProfileScreen.tsx +1 -1
  146. package/templates/react-native/FamilyTemplate/src/animation/useAnimatedList.ts +219 -2
  147. package/templates/react-native/FamilyTemplate/src/animation/useMotionPreferences.ts +23 -9
  148. package/templates/react-native/FamilyTemplate/src/screens/Profile/ProfileScreen.tsx +1 -1
  149. package/templates/react-native/FinanceTemplate/src/animation/useAnimatedList.ts +219 -2
  150. package/templates/react-native/FinanceTemplate/src/animation/useMotionPreferences.ts +23 -9
  151. package/templates/react-native/FinanceTemplate/src/screens/Profile/ProfileScreen.tsx +1 -1
  152. package/templates/react-native/GameTemplate/src/animation/useAnimatedList.ts +219 -2
  153. package/templates/react-native/GameTemplate/src/animation/useMotionPreferences.ts +23 -9
  154. package/templates/react-native/GameTemplate/src/screens/GameDetail/GameDetailScreen.tsx +2 -1
  155. package/templates/react-native/GameTemplate/src/screens/Profile/ProfileScreen.tsx +1 -1
  156. package/templates/react-native/HealthTemplate/src/animation/useAnimatedList.ts +219 -2
  157. package/templates/react-native/HealthTemplate/src/animation/useMotionPreferences.ts +23 -9
  158. package/templates/react-native/HealthTemplate/src/screens/Profile/ProfileScreen.tsx +1 -1
  159. package/templates/react-native/HealthTemplate/src/screens/WorkoutDetail/WorkoutDetailScreen.tsx +1 -1
  160. package/templates/react-native/LearnTemplate/src/animation/useAnimatedList.ts +219 -2
  161. package/templates/react-native/LearnTemplate/src/animation/useMotionPreferences.ts +23 -9
  162. package/templates/react-native/LearnTemplate/src/screens/Profile/ProfileScreen.tsx +1 -1
  163. package/templates/react-native/MapTemplate/src/animation/useAnimatedList.ts +219 -2
  164. package/templates/react-native/MapTemplate/src/animation/useMotionPreferences.ts +23 -9
  165. package/templates/react-native/MapTemplate/src/screens/Map/MapScreen.tsx +14 -0
  166. package/templates/react-native/MapTemplate/src/screens/Profile/ProfileScreen.tsx +1 -1
  167. package/templates/react-native/MediaTemplate/src/animation/useAnimatedList.ts +219 -2
  168. package/templates/react-native/MediaTemplate/src/animation/useMotionPreferences.ts +23 -9
  169. package/templates/react-native/MediaTemplate/src/screens/PlaylistDetail/PlaylistDetailScreen.tsx +1 -1
  170. package/templates/react-native/MediaTemplate/src/screens/Profile/ProfileScreen.tsx +1 -1
  171. package/templates/react-native/ReferenceTemplate/src/animation/useAnimatedList.ts +219 -2
  172. package/templates/react-native/ReferenceTemplate/src/animation/useMotionPreferences.ts +23 -9
  173. package/templates/react-native/ReferenceTemplate/src/screens/Settings/SettingsScreen.tsx +1 -1
  174. package/templates/react-native/ShopTemplate/src/animation/useAnimatedList.ts +219 -2
  175. package/templates/react-native/ShopTemplate/src/animation/useMotionPreferences.ts +23 -9
  176. package/templates/react-native/ShopTemplate/src/screens/Profile/ProfileScreen.tsx +1 -1
  177. package/templates/react-native/Skeleton/TESTING_MANIFEST.md +1 -1
  178. package/templates/react-native/Skeleton/src/animation/useAnimatedList.ts +219 -2
  179. package/templates/react-native/Skeleton/src/animation/useMotionPreferences.ts +23 -9
  180. package/templates/react-native/Skeleton/src/screens/Profile/ProfileScreen.tsx +1 -1
  181. package/templates/react-native/Skeleton/tests/07_profile.yaml +3 -2
  182. package/templates/react-native/Skeleton/tests/08_full_e2e.yaml +12 -1
  183. package/templates/react-native/SocialTemplate/src/animation/useAnimatedList.ts +219 -2
  184. package/templates/react-native/SocialTemplate/src/animation/useMotionPreferences.ts +23 -9
  185. package/templates/react-native/SocialTemplate/src/screens/Feed/FeedScreen.tsx +1 -0
  186. package/templates/react-native/SocialTemplate/src/screens/Profile/ProfileScreen.tsx +1 -1
  187. package/templates/react-native/TaskTemplate/src/animation/useAnimatedList.ts +219 -2
  188. package/templates/react-native/TaskTemplate/src/animation/useMotionPreferences.ts +23 -9
  189. package/templates/react-native/TaskTemplate/src/screens/Profile/ProfileScreen.tsx +1 -1
  190. package/templates/react-native/TrackTemplate/src/animation/useAnimatedList.ts +219 -2
  191. package/templates/react-native/TrackTemplate/src/animation/useMotionPreferences.ts +23 -9
  192. package/templates/react-native/TrackTemplate/src/screens/Settings/SettingsScreen.tsx +1 -1
  193. package/templates/shared/ios/AnimatedTransitions/AnimatedTransitionsView.swift +233 -93
  194. package/.claude/agents/template-selector.md +0 -39
  195. package/.claude/skills/module-selector/SKILL.md +0 -81
  196. package/.claude/skills/template-selector/SKILL.md +0 -44
  197. package/.cursor/agents/template-selector.md +0 -52
  198. package/.cursor/skills/module-selector/SKILL.md +0 -135
  199. package/.cursor/skills/template-selector/SKILL.md +0 -123
@@ -57,6 +57,155 @@ struct BounceScaleModifier: ViewModifier {
57
57
  }
58
58
  }
59
59
 
60
+ // MARK: - Scale on Press Modifier
61
+ /// Applies scale-down + spring-back animation when pressed (like a button press).
62
+ struct ScaleOnPressModifier: ViewModifier {
63
+ @State private var isPressed = false
64
+
65
+ func body(content: Content) -> some View {
66
+ content
67
+ .scaleEffect(isPressed ? 0.95 : 1.0)
68
+ .animation(.spring(response: 0.3, dampingFraction: 0.7), value: isPressed)
69
+ .simultaneousGesture(
70
+ DragGesture(minimumDistance: 0)
71
+ .onChanged { _ in isPressed = true }
72
+ .onEnded { _ in isPressed = false }
73
+ )
74
+ }
75
+ }
76
+
77
+ // MARK: - Haptic Feedback Modifier
78
+ /// Triggers haptic feedback on tap.
79
+ struct HapticFeedbackModifier: ViewModifier {
80
+ let style: UIImpactFeedbackGenerator.FeedbackStyle
81
+
82
+ func body(content: Content) -> some View {
83
+ content
84
+ .onTapGesture {
85
+ UIImpactFeedbackGenerator(style: style).impactOccurred()
86
+ }
87
+ }
88
+ }
89
+
90
+ // MARK: - Slide and Fade Modifier
91
+ /// Applies a slide-from-side + fade-in animation on appear.
92
+ struct SlideAndFadeModifier: ViewModifier {
93
+ let delay: Double
94
+ @State private var isVisible = false
95
+
96
+ func body(content: Content) -> some View {
97
+ content
98
+ .opacity(isVisible ? 1 : 0)
99
+ .offset(x: isVisible ? 0 : 20)
100
+ .motionAware(animation: .spring(response: 0.5, dampingFraction: 0.8).delay(delay))
101
+ .onAppear {
102
+ isVisible = true
103
+ }
104
+ }
105
+ }
106
+
107
+ // MARK: - Card Shadow Modifier
108
+ /// Applies a subtle colored shadow to cards and elevated surfaces.
109
+ struct CardShadowModifier: ViewModifier {
110
+ let color: Color
111
+ let radius: CGFloat
112
+ let y: CGFloat
113
+
114
+ func body(content: Content) -> some View {
115
+ content
116
+ .shadow(color: color.opacity(0.08), radius: radius, x: 0, y: y)
117
+ .shadow(color: Color.black.opacity(0.04), radius: radius / 2, x: 0, y: y / 2)
118
+ }
119
+ }
120
+
121
+ // MARK: - Elevated Shadow Modifier
122
+ /// Applies a deeper shadow for FABs and floating elements.
123
+ struct ElevatedShadowModifier: ViewModifier {
124
+ let color: Color
125
+
126
+ func body(content: Content) -> some View {
127
+ content
128
+ .shadow(color: color.opacity(0.12), radius: 16, x: 0, y: 8)
129
+ .shadow(color: Color.black.opacity(0.06), radius: 8, x: 0, y: 4)
130
+ }
131
+ }
132
+
133
+ // MARK: - Shimmer Modifier
134
+ /// Applies a shimmer/skeleton-loading gradient overlay for loading states.
135
+ struct ShimmerModifier: ViewModifier {
136
+ @State private var isAnimating = false
137
+
138
+ func body(content: Content) -> some View {
139
+ content
140
+ .overlay(
141
+ GeometryReader { geometry in
142
+ if isAnimating {
143
+ LinearGradient(
144
+ colors: [
145
+ Color.clear,
146
+ Color.white.opacity(0.3),
147
+ Color.clear
148
+ ],
149
+ startPoint: .leading,
150
+ endPoint: .trailing
151
+ )
152
+ .offset(x: isAnimating ? geometry.size.width : -geometry.size.width)
153
+ .animation(
154
+ Animation.linear(duration: 1.5)
155
+ .repeatForever(autoreverses: false),
156
+ value: isAnimating
157
+ )
158
+ }
159
+ }
160
+ )
161
+ .clipped()
162
+ .onAppear {
163
+ isAnimating = true
164
+ }
165
+ }
166
+ }
167
+
168
+ // MARK: - Pulse Modifier
169
+ /// Applies a repeating scale pulse effect (e.g., for notifications, active indicators).
170
+ struct PulseModifier: ViewModifier {
171
+ let intensity: CGFloat
172
+ @State private var scale: CGFloat = 1.0
173
+
174
+ func body(content: Content) -> some View {
175
+ content
176
+ .scaleEffect(scale)
177
+ .onAppear {
178
+ withAnimation(
179
+ .easeInOut(duration: 1.0)
180
+ .repeatForever(autoreverses: true)
181
+ ) {
182
+ scale = 1.0 + intensity
183
+ }
184
+ }
185
+ }
186
+ }
187
+
188
+ // MARK: - Heart Bounce Modifier
189
+ /// Applies a scale-up bounce then return when toggled (e.g., favorite/like buttons).
190
+ struct HeartBounceModifier: ViewModifier {
191
+ let isActive: Bool
192
+ @State private var scale: CGFloat = 1.0
193
+
194
+ func body(content: Content) -> some View {
195
+ content
196
+ .scaleEffect(scale)
197
+ .motionAware(animation: .spring(response: 0.3, dampingFraction: 0.5))
198
+ .onChange(of: isActive) { _, newValue in
199
+ if newValue {
200
+ scale = 1.3
201
+ DispatchQueue.main.asyncAfter(deadline: .now() + 0.2) {
202
+ scale = 1.0
203
+ }
204
+ }
205
+ }
206
+ }
207
+ }
208
+
60
209
  // MARK: - View Extensions
61
210
 
62
211
  extension View {
@@ -79,4 +228,56 @@ extension View {
79
228
  func bounceOnChange(isActive: Bool) -> some View {
80
229
  modifier(BounceScaleModifier(isActive: isActive))
81
230
  }
231
+
232
+ /// Applies scale-down press feedback to any tappable element.
233
+ /// Scales to 0.95 on press with spring return animation.
234
+ func scaleOnPress() -> some View {
235
+ modifier(ScaleOnPressModifier())
236
+ }
237
+
238
+ /// Triggers haptic feedback on tap.
239
+ /// - Parameter style: Feedback intensity (.light, .medium, .heavy)
240
+ func hapticFeedback(_ style: UIImpactFeedbackGenerator.FeedbackStyle = .light) -> some View {
241
+ modifier(HapticFeedbackModifier(style: style))
242
+ }
243
+
244
+ /// Applies a slide-from-side + fade-in animation on appear.
245
+ /// - Parameter delay: Delay before animation starts (default: 0)
246
+ func slideAndFade(delay: Double = 0) -> some View {
247
+ modifier(SlideAndFadeModifier(delay: delay))
248
+ }
249
+
250
+ /// Applies subtle colored shadow to cards and elevated surfaces.
251
+ /// Uses dual-shadow technique: primary-tinted shadow + neutral shadow for depth.
252
+ /// - Parameters:
253
+ /// - color: Shadow tint color (default: .primary)
254
+ /// - radius: Shadow blur radius (default: 8)
255
+ /// - y: Vertical offset (default: 4)
256
+ func cardShadow(color: Color = .primary, radius: CGFloat = 8, y: CGFloat = 4) -> some View {
257
+ modifier(CardShadowModifier(color: color, radius: radius, y: y))
258
+ }
259
+
260
+ /// Applies deeper shadow for floating elements (FABs, modals).
261
+ /// - Parameter color: Shadow tint color (default: .primary)
262
+ func elevatedShadow(color: Color = .primary) -> some View {
263
+ modifier(ElevatedShadowModifier(color: color))
264
+ }
265
+
266
+ /// Applies a shimmer loading overlay (e.g., for skeleton placeholder views).
267
+ func shimmer() -> some View {
268
+ modifier(ShimmerModifier())
269
+ }
270
+
271
+ /// Applies a repeating pulse animation (e.g., for notifications, live indicators).
272
+ /// - Parameter intensity: Scale increase per pulse (default: 0.05 = 5% bigger)
273
+ func pulse(intensity: CGFloat = 0.05) -> some View {
274
+ modifier(PulseModifier(intensity: intensity))
275
+ }
276
+
277
+ /// Applies a heart/like bounce effect when toggled active.
278
+ /// Scales up to 1.3x then springs back. Perfect for favorite buttons.
279
+ /// - Parameter isActive: Boolean that triggers the bounce when it becomes true
280
+ func heartBounce(isActive: Bool) -> some View {
281
+ modifier(HeartBounceModifier(isActive: isActive))
282
+ }
82
283
  }
@@ -57,6 +57,155 @@ struct BounceScaleModifier: ViewModifier {
57
57
  }
58
58
  }
59
59
 
60
+ // MARK: - Scale on Press Modifier
61
+ /// Applies scale-down + spring-back animation when pressed (like a button press).
62
+ struct ScaleOnPressModifier: ViewModifier {
63
+ @State private var isPressed = false
64
+
65
+ func body(content: Content) -> some View {
66
+ content
67
+ .scaleEffect(isPressed ? 0.95 : 1.0)
68
+ .animation(.spring(response: 0.3, dampingFraction: 0.7), value: isPressed)
69
+ .simultaneousGesture(
70
+ DragGesture(minimumDistance: 0)
71
+ .onChanged { _ in isPressed = true }
72
+ .onEnded { _ in isPressed = false }
73
+ )
74
+ }
75
+ }
76
+
77
+ // MARK: - Haptic Feedback Modifier
78
+ /// Triggers haptic feedback on tap.
79
+ struct HapticFeedbackModifier: ViewModifier {
80
+ let style: UIImpactFeedbackGenerator.FeedbackStyle
81
+
82
+ func body(content: Content) -> some View {
83
+ content
84
+ .onTapGesture {
85
+ UIImpactFeedbackGenerator(style: style).impactOccurred()
86
+ }
87
+ }
88
+ }
89
+
90
+ // MARK: - Slide and Fade Modifier
91
+ /// Applies a slide-from-side + fade-in animation on appear.
92
+ struct SlideAndFadeModifier: ViewModifier {
93
+ let delay: Double
94
+ @State private var isVisible = false
95
+
96
+ func body(content: Content) -> some View {
97
+ content
98
+ .opacity(isVisible ? 1 : 0)
99
+ .offset(x: isVisible ? 0 : 20)
100
+ .motionAware(animation: .spring(response: 0.5, dampingFraction: 0.8).delay(delay))
101
+ .onAppear {
102
+ isVisible = true
103
+ }
104
+ }
105
+ }
106
+
107
+ // MARK: - Card Shadow Modifier
108
+ /// Applies a subtle colored shadow to cards and elevated surfaces.
109
+ struct CardShadowModifier: ViewModifier {
110
+ let color: Color
111
+ let radius: CGFloat
112
+ let y: CGFloat
113
+
114
+ func body(content: Content) -> some View {
115
+ content
116
+ .shadow(color: color.opacity(0.08), radius: radius, x: 0, y: y)
117
+ .shadow(color: Color.black.opacity(0.04), radius: radius / 2, x: 0, y: y / 2)
118
+ }
119
+ }
120
+
121
+ // MARK: - Elevated Shadow Modifier
122
+ /// Applies a deeper shadow for FABs and floating elements.
123
+ struct ElevatedShadowModifier: ViewModifier {
124
+ let color: Color
125
+
126
+ func body(content: Content) -> some View {
127
+ content
128
+ .shadow(color: color.opacity(0.12), radius: 16, x: 0, y: 8)
129
+ .shadow(color: Color.black.opacity(0.06), radius: 8, x: 0, y: 4)
130
+ }
131
+ }
132
+
133
+ // MARK: - Shimmer Modifier
134
+ /// Applies a shimmer/skeleton-loading gradient overlay for loading states.
135
+ struct ShimmerModifier: ViewModifier {
136
+ @State private var isAnimating = false
137
+
138
+ func body(content: Content) -> some View {
139
+ content
140
+ .overlay(
141
+ GeometryReader { geometry in
142
+ if isAnimating {
143
+ LinearGradient(
144
+ colors: [
145
+ Color.clear,
146
+ Color.white.opacity(0.3),
147
+ Color.clear
148
+ ],
149
+ startPoint: .leading,
150
+ endPoint: .trailing
151
+ )
152
+ .offset(x: isAnimating ? geometry.size.width : -geometry.size.width)
153
+ .animation(
154
+ Animation.linear(duration: 1.5)
155
+ .repeatForever(autoreverses: false),
156
+ value: isAnimating
157
+ )
158
+ }
159
+ }
160
+ )
161
+ .clipped()
162
+ .onAppear {
163
+ isAnimating = true
164
+ }
165
+ }
166
+ }
167
+
168
+ // MARK: - Pulse Modifier
169
+ /// Applies a repeating scale pulse effect (e.g., for notifications, active indicators).
170
+ struct PulseModifier: ViewModifier {
171
+ let intensity: CGFloat
172
+ @State private var scale: CGFloat = 1.0
173
+
174
+ func body(content: Content) -> some View {
175
+ content
176
+ .scaleEffect(scale)
177
+ .onAppear {
178
+ withAnimation(
179
+ .easeInOut(duration: 1.0)
180
+ .repeatForever(autoreverses: true)
181
+ ) {
182
+ scale = 1.0 + intensity
183
+ }
184
+ }
185
+ }
186
+ }
187
+
188
+ // MARK: - Heart Bounce Modifier
189
+ /// Applies a scale-up bounce then return when toggled (e.g., favorite/like buttons).
190
+ struct HeartBounceModifier: ViewModifier {
191
+ let isActive: Bool
192
+ @State private var scale: CGFloat = 1.0
193
+
194
+ func body(content: Content) -> some View {
195
+ content
196
+ .scaleEffect(scale)
197
+ .motionAware(animation: .spring(response: 0.3, dampingFraction: 0.5))
198
+ .onChange(of: isActive) { _, newValue in
199
+ if newValue {
200
+ scale = 1.3
201
+ DispatchQueue.main.asyncAfter(deadline: .now() + 0.2) {
202
+ scale = 1.0
203
+ }
204
+ }
205
+ }
206
+ }
207
+ }
208
+
60
209
  // MARK: - View Extensions
61
210
 
62
211
  extension View {
@@ -79,4 +228,56 @@ extension View {
79
228
  func bounceOnChange(isActive: Bool) -> some View {
80
229
  modifier(BounceScaleModifier(isActive: isActive))
81
230
  }
231
+
232
+ /// Applies scale-down press feedback to any tappable element.
233
+ /// Scales to 0.95 on press with spring return animation.
234
+ func scaleOnPress() -> some View {
235
+ modifier(ScaleOnPressModifier())
236
+ }
237
+
238
+ /// Triggers haptic feedback on tap.
239
+ /// - Parameter style: Feedback intensity (.light, .medium, .heavy)
240
+ func hapticFeedback(_ style: UIImpactFeedbackGenerator.FeedbackStyle = .light) -> some View {
241
+ modifier(HapticFeedbackModifier(style: style))
242
+ }
243
+
244
+ /// Applies a slide-from-side + fade-in animation on appear.
245
+ /// - Parameter delay: Delay before animation starts (default: 0)
246
+ func slideAndFade(delay: Double = 0) -> some View {
247
+ modifier(SlideAndFadeModifier(delay: delay))
248
+ }
249
+
250
+ /// Applies subtle colored shadow to cards and elevated surfaces.
251
+ /// Uses dual-shadow technique: primary-tinted shadow + neutral shadow for depth.
252
+ /// - Parameters:
253
+ /// - color: Shadow tint color (default: .primary)
254
+ /// - radius: Shadow blur radius (default: 8)
255
+ /// - y: Vertical offset (default: 4)
256
+ func cardShadow(color: Color = .primary, radius: CGFloat = 8, y: CGFloat = 4) -> some View {
257
+ modifier(CardShadowModifier(color: color, radius: radius, y: y))
258
+ }
259
+
260
+ /// Applies deeper shadow for floating elements (FABs, modals).
261
+ /// - Parameter color: Shadow tint color (default: .primary)
262
+ func elevatedShadow(color: Color = .primary) -> some View {
263
+ modifier(ElevatedShadowModifier(color: color))
264
+ }
265
+
266
+ /// Applies a shimmer loading overlay (e.g., for skeleton placeholder views).
267
+ func shimmer() -> some View {
268
+ modifier(ShimmerModifier())
269
+ }
270
+
271
+ /// Applies a repeating pulse animation (e.g., for notifications, live indicators).
272
+ /// - Parameter intensity: Scale increase per pulse (default: 0.05 = 5% bigger)
273
+ func pulse(intensity: CGFloat = 0.05) -> some View {
274
+ modifier(PulseModifier(intensity: intensity))
275
+ }
276
+
277
+ /// Applies a heart/like bounce effect when toggled active.
278
+ /// Scales up to 1.3x then springs back. Perfect for favorite buttons.
279
+ /// - Parameter isActive: Boolean that triggers the bounce when it becomes true
280
+ func heartBounce(isActive: Bool) -> some View {
281
+ modifier(HeartBounceModifier(isActive: isActive))
282
+ }
82
283
  }
@@ -4,4 +4,16 @@ import Foundation
4
4
  /// Root enum for all string extensions.
5
5
  /// Each feature module extends this enum with its own nested enum.
6
6
  enum Strings {
7
+ // MARK: - Motion Preferences
8
+ enum MotionPreferences {
9
+ static let animationLevel = "Animations"
10
+ static let description = "Controls how animations and transitions appear throughout the app. System Reduce Motion setting is always respected."
11
+ static let reduceMotionActive = "System Reduce Motion is enabled. Animations will be simplified."
12
+ static let intensityFull = "Full"
13
+ static let intensityReduced = "Reduced"
14
+ static let intensityOff = "Off"
15
+ static let fullDescription = "All animations and transitions enabled"
16
+ static let reducedDescription = "Simplified cross-fade transitions only"
17
+ static let offDescription = "No animations — instant state changes"
18
+ }
7
19
  }
@@ -156,43 +156,8 @@ struct SkeletonDetailView: View {
156
156
  }
157
157
 
158
158
  // MARK: - Shimmer Modifier
159
- struct ShimmerModifier: ViewModifier {
160
- @State private var isAnimating = false
161
-
162
- func body(content: Content) -> some View {
163
- content
164
- .overlay(
165
- GeometryReader { geometry in
166
- if isAnimating {
167
- LinearGradient(
168
- colors: [
169
- Color.clear,
170
- Color.white.opacity(0.3),
171
- Color.clear
172
- ],
173
- startPoint: .leading,
174
- endPoint: .trailing
175
- )
176
- .offset(x: isAnimating ? geometry.size.width : -geometry.size.width)
177
- .animation(
178
- Animation.linear(duration: 1.5)
179
- .repeatForever(autoreverses: false),
180
- value: isAnimating
181
- )
182
- }
183
- }
184
- )
185
- .onAppear {
186
- isAnimating = true
187
- }
188
- }
189
- }
190
-
191
- extension View {
192
- func shimmer() -> some View {
193
- modifier(ShimmerModifier())
194
- }
195
- }
159
+ // ShimmerModifier and .shimmer() are now built-in via AnimatedTransitionsView.swift.
160
+ // No duplicate definition needed here.
196
161
 
197
162
  // MARK: - Skeleton Loading View (Convenience)
198
163
  /// Convenience wrapper for common skeleton loading patterns.
@@ -57,6 +57,155 @@ struct BounceScaleModifier: ViewModifier {
57
57
  }
58
58
  }
59
59
 
60
+ // MARK: - Scale on Press Modifier
61
+ /// Applies scale-down + spring-back animation when pressed (like a button press).
62
+ struct ScaleOnPressModifier: ViewModifier {
63
+ @State private var isPressed = false
64
+
65
+ func body(content: Content) -> some View {
66
+ content
67
+ .scaleEffect(isPressed ? 0.95 : 1.0)
68
+ .animation(.spring(response: 0.3, dampingFraction: 0.7), value: isPressed)
69
+ .simultaneousGesture(
70
+ DragGesture(minimumDistance: 0)
71
+ .onChanged { _ in isPressed = true }
72
+ .onEnded { _ in isPressed = false }
73
+ )
74
+ }
75
+ }
76
+
77
+ // MARK: - Haptic Feedback Modifier
78
+ /// Triggers haptic feedback on tap.
79
+ struct HapticFeedbackModifier: ViewModifier {
80
+ let style: UIImpactFeedbackGenerator.FeedbackStyle
81
+
82
+ func body(content: Content) -> some View {
83
+ content
84
+ .onTapGesture {
85
+ UIImpactFeedbackGenerator(style: style).impactOccurred()
86
+ }
87
+ }
88
+ }
89
+
90
+ // MARK: - Slide and Fade Modifier
91
+ /// Applies a slide-from-side + fade-in animation on appear.
92
+ struct SlideAndFadeModifier: ViewModifier {
93
+ let delay: Double
94
+ @State private var isVisible = false
95
+
96
+ func body(content: Content) -> some View {
97
+ content
98
+ .opacity(isVisible ? 1 : 0)
99
+ .offset(x: isVisible ? 0 : 20)
100
+ .motionAware(animation: .spring(response: 0.5, dampingFraction: 0.8).delay(delay))
101
+ .onAppear {
102
+ isVisible = true
103
+ }
104
+ }
105
+ }
106
+
107
+ // MARK: - Card Shadow Modifier
108
+ /// Applies a subtle colored shadow to cards and elevated surfaces.
109
+ struct CardShadowModifier: ViewModifier {
110
+ let color: Color
111
+ let radius: CGFloat
112
+ let y: CGFloat
113
+
114
+ func body(content: Content) -> some View {
115
+ content
116
+ .shadow(color: color.opacity(0.08), radius: radius, x: 0, y: y)
117
+ .shadow(color: Color.black.opacity(0.04), radius: radius / 2, x: 0, y: y / 2)
118
+ }
119
+ }
120
+
121
+ // MARK: - Elevated Shadow Modifier
122
+ /// Applies a deeper shadow for FABs and floating elements.
123
+ struct ElevatedShadowModifier: ViewModifier {
124
+ let color: Color
125
+
126
+ func body(content: Content) -> some View {
127
+ content
128
+ .shadow(color: color.opacity(0.12), radius: 16, x: 0, y: 8)
129
+ .shadow(color: Color.black.opacity(0.06), radius: 8, x: 0, y: 4)
130
+ }
131
+ }
132
+
133
+ // MARK: - Shimmer Modifier
134
+ /// Applies a shimmer/skeleton-loading gradient overlay for loading states.
135
+ struct ShimmerModifier: ViewModifier {
136
+ @State private var isAnimating = false
137
+
138
+ func body(content: Content) -> some View {
139
+ content
140
+ .overlay(
141
+ GeometryReader { geometry in
142
+ if isAnimating {
143
+ LinearGradient(
144
+ colors: [
145
+ Color.clear,
146
+ Color.white.opacity(0.3),
147
+ Color.clear
148
+ ],
149
+ startPoint: .leading,
150
+ endPoint: .trailing
151
+ )
152
+ .offset(x: isAnimating ? geometry.size.width : -geometry.size.width)
153
+ .animation(
154
+ Animation.linear(duration: 1.5)
155
+ .repeatForever(autoreverses: false),
156
+ value: isAnimating
157
+ )
158
+ }
159
+ }
160
+ )
161
+ .clipped()
162
+ .onAppear {
163
+ isAnimating = true
164
+ }
165
+ }
166
+ }
167
+
168
+ // MARK: - Pulse Modifier
169
+ /// Applies a repeating scale pulse effect (e.g., for notifications, active indicators).
170
+ struct PulseModifier: ViewModifier {
171
+ let intensity: CGFloat
172
+ @State private var scale: CGFloat = 1.0
173
+
174
+ func body(content: Content) -> some View {
175
+ content
176
+ .scaleEffect(scale)
177
+ .onAppear {
178
+ withAnimation(
179
+ .easeInOut(duration: 1.0)
180
+ .repeatForever(autoreverses: true)
181
+ ) {
182
+ scale = 1.0 + intensity
183
+ }
184
+ }
185
+ }
186
+ }
187
+
188
+ // MARK: - Heart Bounce Modifier
189
+ /// Applies a scale-up bounce then return when toggled (e.g., favorite/like buttons).
190
+ struct HeartBounceModifier: ViewModifier {
191
+ let isActive: Bool
192
+ @State private var scale: CGFloat = 1.0
193
+
194
+ func body(content: Content) -> some View {
195
+ content
196
+ .scaleEffect(scale)
197
+ .motionAware(animation: .spring(response: 0.3, dampingFraction: 0.5))
198
+ .onChange(of: isActive) { _, newValue in
199
+ if newValue {
200
+ scale = 1.3
201
+ DispatchQueue.main.asyncAfter(deadline: .now() + 0.2) {
202
+ scale = 1.0
203
+ }
204
+ }
205
+ }
206
+ }
207
+ }
208
+
60
209
  // MARK: - View Extensions
61
210
 
62
211
  extension View {
@@ -79,4 +228,56 @@ extension View {
79
228
  func bounceOnChange(isActive: Bool) -> some View {
80
229
  modifier(BounceScaleModifier(isActive: isActive))
81
230
  }
231
+
232
+ /// Applies scale-down press feedback to any tappable element.
233
+ /// Scales to 0.95 on press with spring return animation.
234
+ func scaleOnPress() -> some View {
235
+ modifier(ScaleOnPressModifier())
236
+ }
237
+
238
+ /// Triggers haptic feedback on tap.
239
+ /// - Parameter style: Feedback intensity (.light, .medium, .heavy)
240
+ func hapticFeedback(_ style: UIImpactFeedbackGenerator.FeedbackStyle = .light) -> some View {
241
+ modifier(HapticFeedbackModifier(style: style))
242
+ }
243
+
244
+ /// Applies a slide-from-side + fade-in animation on appear.
245
+ /// - Parameter delay: Delay before animation starts (default: 0)
246
+ func slideAndFade(delay: Double = 0) -> some View {
247
+ modifier(SlideAndFadeModifier(delay: delay))
248
+ }
249
+
250
+ /// Applies subtle colored shadow to cards and elevated surfaces.
251
+ /// Uses dual-shadow technique: primary-tinted shadow + neutral shadow for depth.
252
+ /// - Parameters:
253
+ /// - color: Shadow tint color (default: .primary)
254
+ /// - radius: Shadow blur radius (default: 8)
255
+ /// - y: Vertical offset (default: 4)
256
+ func cardShadow(color: Color = .primary, radius: CGFloat = 8, y: CGFloat = 4) -> some View {
257
+ modifier(CardShadowModifier(color: color, radius: radius, y: y))
258
+ }
259
+
260
+ /// Applies deeper shadow for floating elements (FABs, modals).
261
+ /// - Parameter color: Shadow tint color (default: .primary)
262
+ func elevatedShadow(color: Color = .primary) -> some View {
263
+ modifier(ElevatedShadowModifier(color: color))
264
+ }
265
+
266
+ /// Applies a shimmer loading overlay (e.g., for skeleton placeholder views).
267
+ func shimmer() -> some View {
268
+ modifier(ShimmerModifier())
269
+ }
270
+
271
+ /// Applies a repeating pulse animation (e.g., for notifications, live indicators).
272
+ /// - Parameter intensity: Scale increase per pulse (default: 0.05 = 5% bigger)
273
+ func pulse(intensity: CGFloat = 0.05) -> some View {
274
+ modifier(PulseModifier(intensity: intensity))
275
+ }
276
+
277
+ /// Applies a heart/like bounce effect when toggled active.
278
+ /// Scales up to 1.3x then springs back. Perfect for favorite buttons.
279
+ /// - Parameter isActive: Boolean that triggers the bounce when it becomes true
280
+ func heartBounce(isActive: Bool) -> some View {
281
+ modifier(HeartBounceModifier(isActive: isActive))
282
+ }
82
283
  }