wind: Instructions file for GitHub Copilot

Test conventions (test/)

Layout mirror

test/ mirrors lib/src/ exactly. One production file → one test file:

• lib/src/widgets/w_button.dart → test/widgets/w_button_test.dart
• lib/src/parser/parsers/padding_parser.dart → test/parser/parsers/padding_parser_test.dart

For widgets with large surface area, sub-directory: test/widgets/w_div/spacing_test.dart, test/widgets/w_div/overflow_test.dart, etc. Mirror that under test/widgets/<name>/.

Required setUp

Parser tests + every widget test that pumps className-styled widgets:

setUp(() {
  WindParser.clearCache();
});

Skipping WindParser.clearCache() is the single biggest source of false-positive cross-test pollution. The parser cache persists between tests; a sibling test priming the cache makes the next test report PASS even when the production logic regressed.

Canonical helpers (duplicate per file, no shared extraction)

Widget tests define wrapWithTheme at the top:

Widget wrapWithTheme(Widget child) {
  return MaterialApp(
    home: WindTheme(
      data: WindThemeData(),
      child: Scaffold(body: child),
    ),
  );
}

Parser tests define createTestContext at the top with 7-8 named params:

WindContext createTestContext({
  bool isHovering = false,
  bool isFocused = false,
  bool isDisabled = false,
  String activeBreakpoint = 'md',
  Brightness brightness = Brightness.light,
  String platform = 'web',
  bool isMobile = false,
}) => WindContext(
      theme: testTheme,
      screenWidth: 400,
      screenHeight: 800,
      activeBreakpoint: activeBreakpoint,
      brightness: brightness,
      platform: platform,
      isMobile: isMobile,
      activeStates: {
        if (isHovering) 'hover',
        if (isFocused) 'focus',
        if (isDisabled) 'disabled',
      },
    );

Duplicate is intentional — keeps each file's helper trivially editable for local tweaks. Do not extract into test/test_utils.dart.

No mockito

Wind tests use NO mocking library. Fake via:

• Constructor injection (WActionHandler(actions: {'foo': (args) => ...}, state: WDynamicState()))
• Stub widgets that implement the contract
• debugDefaultTargetPlatformOverride for Platform.is* paths (inside try/finally — reset is mandatory)