chore: project configuration updates

  - Update melos and pubspec configurations
  - Add project documentation and guidelines
  - Update renovate and prettier configurations

Author: wasabeef

CLAUDE.md

@@ -0,0 +1,152 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+Flutter Hooks Test is a testing utility library for Flutter hooks, inspired by React's `react-hooks-testing-library`. It provides a simple API to test custom hooks in isolation.
+
+## Development Commands
+
+### Essential Commands
+
+```bash
+# Install dependencies
+melos get
+bun install
+
+# Run tests
+melos test
+
+# Run code analysis
+melos analyze
+
+# Format code (Dart + Prettier)
+melos format
+
+# Run all checks (analyze + format + test)
+melos analyze && melos format && melos test
+
+# Run a single test file
+flutter test test/flutter_hooks_test_test.dart
+
+# Run tests with coverage
+flutter test --coverage
+```
+
+### Additional Commands
+
+```bash
+# Upgrade dependencies
+melos upgrade
+
+# Clean build artifacts
+melos clean
+
+# Format with Prettier only
+bun run format
+
+# Setup git hooks
+bun run prepare
+```
+
+## Architecture and Code Structure
+
+### Core API
+
+The library exports a single file `lib/flutter_hooks_test.dart` containing:
+
+1. **`buildHook<T, P>`** - Main function to test hooks
+
+   - Generic `T`: Return type of the hook
+   - Generic `P`: Props type for parameterized hooks
+   - Returns `_HookTestingAction<T>` with methods:
+     - `current`: Access current hook value
+     - `rebuild([props])`: Trigger rebuild with optional new props
+     - `unmount()`: Unmount the hook
+
+2. **`act`** - Wraps state changes to ensure proper Flutter test lifecycle
+   - Similar to React's `act` function
+   - Required when changing hook state
+
+### Testing Pattern
+
+```dart
+// Basic hook test structure
+final result = await buildHook((_) => useMyHook());
+await act(() => result.current.doSomething());
+expect(result.current.value, expectedValue);
+
+// With wrapper widget
+final result = await buildHook(
+  (_) => useMyHook(),
+  wrapper: (child) => Provider(child: child),
+);
+```
+
+### Internal Implementation
+
+- Uses `TestWidgetsFlutterBinding` for test environment
+- Creates a minimal widget tree with `HookBuilder`
+- Manages completer-based async operations for mount/unmount
+- Preserves hook state across rebuilds using keys
+
+## Testing Approach
+
+- All tests go in `test/` directory
+- Example hooks in `test/hooks/` demonstrate testable patterns
+- Use `testWidgets` for widget-based tests
+- Use Mockito for mocking dependencies
+
+## Code Quality
+
+- Flutter lints are enforced via `analysis_options.yaml`
+- Example directory is excluded from analysis
+- Pre-commit hooks format code automatically
+- CI runs on Ubuntu with asdf version management
+
+## Important Conventions
+
+1. **Type Safety**: Always specify generic types when using `buildHook`
+2. **Act Wrapper**: Always wrap state changes in `act()`
+3. **Async Handling**: Most operations return Futures - use `await`
+4. **Testing**: Test both happy paths and edge cases (mount/unmount/rebuild)
+
+## Version Requirements
+
+- Dart SDK: `>=2.17.0 <4.0.0`
+- Flutter: `>=3.20.0`
+- Uses Flutter hooks `^0.21.2`
+
+## Release Process
+
+Releases are fully automated via GitHub Actions:
+
+### Creating a Release
+
+1. **Update version**: Update version in `pubspec.yaml`
+2. **Update changelog**: Run `git cliff --unreleased --tag v1.0.1 --output CHANGELOG.md`
+3. **Commit changes**: `git commit -am "chore(release): prepare for v1.0.1"`
+4. **Create tag**: `git tag v1.0.1`
+5. **Push**: `git push origin main --tags`
+
+### Automated Release Steps
+
+When a tag matching `v[0-9]+.[0-9]+.[0-9]+*` is pushed:
+
+1. **CI Validation**: All tests, formatting, and analysis must pass
+2. **Dry Run**: Package publication is tested
+3. **Release Notes**: Auto-generated using git-cliff from conventional commits
+4. **GitHub Release**: Created with generated release notes
+5. **pub.dev Publication**: Package is published automatically
+
+### Commit Convention
+
+Use [Conventional Commits](https://www.conventionalcommits.org/) for automatic release note generation:
+
+- `feat:` - New features
+- `fix:` - Bug fixes
+- `docs:` - Documentation changes
+- `test:` - Test improvements
+- `refactor:` - Code refactoring
+- `perf:` - Performance improvements

example/lib/main.dart

@@ -38,7 +38,7 @@ void main() {
   testWidgets('Using flutter_hooks_test', (tester) async {
     // After
     var buildCount = 0;
-    final result = await buildHook((_) {
+    final result = await buildHook(() {
       buildCount++;
       return useUpdate();
     });
@@ -50,14 +50,14 @@ void main() {
   });
 
   testWidgets('should rebuild after act()', (tester) async {
-    final result = await buildHook((_) => useCounter(5));
+    final result = await buildHook(() => useCounter(5));
     await act(() => result.current.inc());
     expect(result.current.value, 6);
   });
 
   testWidgets('should unmount after unmount()', (tester) async {
     final effect = MockEffect();
-    final result = await buildHook((_) => useMount(() => effect()));
+    final result = await buildHook(() => useMount(() => effect()));
     verify(effect()).called(1);
     verifyNoMoreInteractions(effect);
     await result.unmount();
@@ -67,19 +67,58 @@ void main() {
 
   testWidgets('should rebuild after rebuild()', (tester) async {
     final effect = MockEffect();
-    final result = await buildHook((_) => useMount(() => effect()));
+    final result = await buildHook(() => useMount(() => effect()));
     await result.rebuild();
     verify(effect()).called(1);
     verifyNoMoreInteractions(effect);
   });
 
   testWidgets('should rebuild after rebuild() with parameter', (tester) async {
-    final result = await buildHook(
+    final result = await buildHookWithProps(
       (count) => useLatest(count),
       initialProps: 123,
     );
     expect(result.current, 123);
-    await result.rebuild(456);
+    await result.rebuildWithProps(456);
     expect(result.current, 456);
   });
+
+  testWidgets('should track build history with new API', (tester) async {
+    final result = await buildHook(() => useCounter(0));
+
+    // Debug information
+    result.debug();
+
+    // Initial build
+    expect(result.buildCount, 1);
+    expect(result.all.length, 1);
+    expect(result.all.first.value, 0);
+
+    // After increment
+    await act(() => result.current.inc());
+    expect(result.buildCount, 2);
+    expect(result.all.length, 2);
+    expect(result.all.last.value, 1);
+  });
+
+  testWidgets('should demonstrate waitFor utilities', (tester) async {
+    final result = await buildHook(() => useCounter(0));
+
+    // Wait for initial condition
+    await waitFor(() => result.current.value == 0);
+
+    // Increment and wait for change
+    await act(() => result.current.inc());
+    await waitFor(() => result.current.value == 1);
+
+    // Use extension method to wait for specific condition
+    await act(() => result.current.inc());
+    await act(() => result.current.inc());
+
+    final finalValue = await result.waitForValueToMatch(
+      (counter) => counter.value >= 3,
+    );
+
+    expect(finalValue.value, 3);
+  });
 }

melos.yaml

@@ -15,7 +15,13 @@ scripts:
 
   analyze: melos exec -- flutter analyze .
 
-  format: melos exec -- dart format .
+  format:
+    run: |
+      melos exec -- dart format .
+      bunx prettier --write .
 
   test:
     run: melos exec -- flutter test
+
+  clean:
+    run: melos exec -- flutter clean

prettier.config.js

@@ -9,6 +9,4 @@ export default {
   trailingComma: 'all',
   arrowParens: 'always',
   endOfLine: 'lf',
-  xmlWhitespaceSensitivity: 'ignore',
-  plugins: ['@prettier/plugin-xml', 'prettier-plugin-packagejson'],
 };

pubspec.yaml

@@ -20,5 +20,5 @@ dependencies:
 
 dev_dependencies:
   flutter_lints: ^6.0.0
-  mockito: ^5.4.6
+  mockito: ^5.4.4
   melos: ^6.3.3

renovate.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
+  "extends": ["config:base"],
+  "schedule": ["before 10am on monday"],
+  "timezone": "Asia/Tokyo",
+  "packageRules": [
+    {
+      "matchPackageNames": ["flutter", "dart"],
+      "enabled": false
+    }
+  ]
+}