/// The app's design tokens: one identical palette shared across every one /// of kuhy's apps (Flutter, web, Python/Tkinter alike) — see the /// `unified-design-system` skill (`~/.claude/skills/unified-design-system/`) /// for the frozen token table this file implements. Built from an explicit /// `ColorScheme`, not `ColorScheme.fromSeed`, because the shared palette is /// hand-picked, not algorithmically derived from one seed color. library; import 'package:flutter/material.dart'; /// Builds the app's single dark `ThemeData` from the shared token set. ThemeData buildAppTheme() { const colorScheme = ColorScheme.dark( surface: Color(0xFF211D1B), // ink surfaceContainerHighest: Color(0xFF38312E), // ink-raised-2 surfaceContainerHigh: Color(0xFF2B2624), // ink-raised-1 onSurface: Color(0xFFECEAE9), // text-on-dark onSurfaceVariant: Color(0xFFAAA09A), // muted-on-dark outline: Color(0xFF463E3A), // line-dark primary: Color(0xFFB8862E), // accent onPrimary: Color(0xFF211D1B), // on-fill secondary: Color(0xFFB8862E), // accent onSecondary: Color(0xFF211D1B), // on-fill secondaryContainer: Color(0xFF463E3A), // line-dark onSecondaryContainer: Color(0xFFB8862E), // accent tertiary: Color(0xFFB8862E), // accent onTertiary: Color(0xFF211D1B), // on-fill tertiaryContainer: Color(0xFF463E3A), // line-dark onTertiaryContainer: Color(0xFFB8862E), // accent error: Color(0xFFE2585F), // danger onError: Color(0xFF211D1B), // on-fill ); return ThemeData( useMaterial3: true, colorScheme: colorScheme, scaffoldBackgroundColor: colorScheme.surface, extensions: const [AppStatusColors.dark], textTheme: const TextTheme( bodyLarge: TextStyle(fontSize: AppTextSize.body), bodyMedium: TextStyle(fontSize: AppTextSize.body), titleLarge: TextStyle(fontSize: AppTextSize.title), titleMedium: TextStyle(fontSize: AppTextSize.subtitle), labelMedium: TextStyle(fontSize: AppTextSize.label), labelSmall: TextStyle(fontSize: AppTextSize.caption), ), inputDecorationTheme: InputDecorationTheme( filled: true, fillColor: colorScheme.surfaceContainerHigh, border: OutlineInputBorder( borderRadius: BorderRadius.circular(AppRadius.sm), borderSide: BorderSide(color: colorScheme.outline), ), enabledBorder: OutlineInputBorder( borderRadius: BorderRadius.circular(AppRadius.sm), borderSide: BorderSide(color: colorScheme.outline), ), focusedBorder: OutlineInputBorder( borderRadius: BorderRadius.circular(AppRadius.sm), borderSide: BorderSide(color: colorScheme.primary, width: 2), ), labelStyle: TextStyle(color: colorScheme.onSurfaceVariant), ), dividerTheme: DividerThemeData( color: colorScheme.outline, thickness: 1, space: AppSpacing.md, ), ); } /// Semantic status colors M3's [ColorScheme] has no role for (it only has /// `error`). Success/warning are the shared `unified-design-system` values — /// every status indicator (set completed, break running, budget pending) /// should read these instead of an ad hoc `Colors.greenAccent`/`orangeAccent`. @immutable class AppStatusColors extends ThemeExtension { /// Creates a status-color set. const AppStatusColors({required this.success, required this.warning}); /// The shared dark-theme instance — success/warning from the unified /// palette (danger already exists as `colorScheme.error`). static const dark = AppStatusColors( success: Color(0xFF8A9A3C), warning: Color(0xFFE0A63C), ); /// Positive/on-track status (e.g. a completed set, an earned skip). final Color success; /// Caution/pending status (e.g. a running break, a near-exhausted budget). final Color warning; @override AppStatusColors copyWith({Color? success, Color? warning}) => AppStatusColors( success: success ?? this.success, warning: warning ?? this.warning, ); @override AppStatusColors lerp(AppStatusColors? other, double t) { if (other is! AppStatusColors) return this; return AppStatusColors( success: Color.lerp(success, other.success, t) ?? success, warning: Color.lerp(warning, other.warning, t) ?? warning, ); } } /// Shared spacing scale (4px base) — round any new value to one of these /// instead of introducing an off-scale literal. abstract final class AppSpacing { /// 4px. static const double xs = 4; /// 8px. static const double sm = 8; /// 16px. static const double md = 16; /// 24px. static const double lg = 24; /// 32px. static const double xl = 32; /// 48px. static const double xxl = 48; } /// Shared corner-radius scale. Nested radii should be `outer - gap`, not a /// fixed constant — compute per instance per safe-design-rules rule 24. abstract final class AppRadius { /// Buttons, inputs, chips. static const double sm = 8; /// Cards. static const double md = 12; /// Sheets, dialogs. static const double lg = 16; } /// Shared type scale (px). `body` is the floor for anything a user reads; /// `label`/`caption` are for UI chrome only (timestamps, badges, tags). abstract final class AppTextSize { /// 12px — chrome only. static const double caption = 12; /// 14px — chrome only. static const double label = 14; /// 16px — the floor for actual reading content. static const double body = 16; /// 20px. static const double subtitle = 20; /// 24px. static const double title = 24; /// 32px. static const double display = 32; } /// Shared motion durations, transcribed from `unified-design-system` /// (`DOCS-motion.md`). Four steps on purpose: a longer scale gets picked from /// at random. Needing one that is not here means the interaction is wrong. abstract final class AppDuration { /// No animation; what every step collapses to under reduced motion. static const Duration instant = Duration.zero; /// 120ms: state on an element already under the finger (press, tick). static const Duration fast = Duration(milliseconds: 120); /// 200ms: the default; anything entering, leaving or moving in view. static const Duration base = Duration(milliseconds: 200); /// 320ms: a full-surface change (dialog, sheet). The ceiling, not a midpoint. static const Duration slow = Duration(milliseconds: 320); } /// Shared easing curves, named for what the motion does at its end. abstract final class AppCurve { /// The default for anything that starts and ends on screen. static const Curve standard = Cubic(0.2, 0, 0, 1); /// Entering the screen: full speed at first, easing to rest. static const Curve decelerate = Cubic(0, 0, 0, 1); /// Leaving the screen: eases in, exits at speed. static const Curve accelerate = Cubic(0.3, 0, 1, 1); } /// [wanted], or [Duration.zero] when the OS asks for no animation. /// /// Haptics and sound are not motion and ignore this on purpose: someone who /// removed animations has not asked to stop hearing that a tap landed. Duration motionDuration(BuildContext context, Duration wanted) => MediaQuery.disableAnimationsOf(context) ? Duration.zero : wanted;