feat(generator): auto-discover and generate factories for nested types

.fvm/fvm_config.json

@@ -0,0 +1,3 @@
+{
+  "flutterSdkVersion": "3.41.9"
+}

.fvmrc

@@ -0,0 +1,3 @@
+{
+  "flutter": "3.41.9"
+}

.github/actions/setup/action.yml

@@ -1,14 +1,25 @@
-name: Setup Dart environment and get dependencies
-description: Installs Dart SDK 2.12.0 and runs `dart pub get` to fetch project dependencies
+name: Setup Dart environment
+description: Installs Dart SDK 3.7, activates Melos, and bootstraps the workspace
 
 runs:
   using: "composite"
   steps:
     - name: Install Dart
-      uses: dart-lang/setup-dart@v1.4
+      uses: dart-lang/setup-dart@v1
       with:
-        sdk: 2.14.0
+        sdk: "3.7"
 
-    - name: Get dependencies
+    - name: Cache pub dependencies
+      uses: actions/cache@v4
+      with:
+        path: ~/.pub-cache
+        key: ${{ runner.os }}-pub-${{ hashFiles('**/pubspec.yaml') }}
+        restore-keys: ${{ runner.os }}-pub-
+
+    - name: Activate Melos
+      shell: bash
+      run: dart pub global activate melos
+
+    - name: Bootstrap workspace
       shell: bash
-      run: dart pub get
+      run: melos bootstrap

.github/workflows/analyze.yml

@@ -8,8 +8,8 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout code
-        uses: actions/checkout@v6
-      - name: Setup Dart
+        uses: actions/checkout@v4
+      - name: Setup
         uses: ./.github/actions/setup
       - name: Analyze
-        run: dart analyze
+        run: melos run analyze

.github/workflows/default.yml

@@ -3,10 +3,14 @@ name: Dart CI
 on:
   pull_request:
   push:
+    branches:
+      - main
+    tags:
+      - "v*"
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: true
+  cancel-in-progress: ${{ !startsWith(github.ref, 'refs/tags/') }}
 
 jobs:
   test:
@@ -28,4 +32,4 @@ jobs:
     needs:
       - release
     name: Publish
-    uses: ./.github/workflows/publish.yml
+    uses: ./.github/workflows/publish.yml

.github/workflows/publish.yml

@@ -5,7 +5,14 @@ on:
 
 jobs:
   publish:
-    if: startsWith(github.ref, 'refs/tags/')
+    if: startsWith(github.ref, 'refs/tags/v')
+    runs-on: ubuntu-latest
     permissions:
       id-token: write
-    uses: dart-lang/setup-dart/.github/workflows/publish.yml@v1
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+      - name: Setup
+        uses: ./.github/actions/setup
+      - name: Publish packages
+        run: melos publish --no-dry-run --yes

.github/workflows/release.yml

@@ -5,10 +5,10 @@ on:
 
 jobs:
   release:
+    if: startsWith(github.ref, 'refs/tags/v')
     runs-on: ubuntu-latest
     steps:
       - name: Create GitHub Release
         uses: softprops/action-gh-release@v2
-        if: startsWith(github.ref, 'refs/tags/')
         env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/test.yml

@@ -8,8 +8,18 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout code
-        uses: actions/checkout@v6
-      - name: Setup Dart
+        uses: actions/checkout@v4
+      - name: Setup
         uses: ./.github/actions/setup
-      - name: Run Tests
-        run: dart test
+      - name: Run tests
+        run: melos run test
+
+  example-build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+      - name: Setup
+        uses: ./.github/actions/setup
+      - name: Build example
+        run: melos run build

.gitignore

@@ -1,3 +1,9 @@
+# Superpowers
+docs/superpowers/
+
+# FVM
+.fvm/flutter_sdk
+
 # Miscellaneous
 *.class
 *.log

CLAUDE.md

@@ -0,0 +1,68 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Purpose
+
+Test fixture library for Dart/Flutter projects. Solves the problem of creating realistic fake model instances in tests without boilerplate. Instead of hand-crafting constructors with dummy data in every test file, you define a factory once and call `makeSingle()` / `makeMany(n)` anywhere.
+
+Core dependency is `package:faker` (re-exported), which supplies realistic random data (names, dates, companies, etc.).
+
+### When to use which method
+
+| Need | Method |
+|---|---|
+| Model instance for a test | `makeSingle()` / `makeMany(n)` |
+| JSON map (e.g. to test a deserializer) | `makeJsonObject()` / `makeJsonArray(n)` |
+| Both model + JSON in sync (e.g. to test round-trip serialization) | `makeSingleWithJsonObject()` / `makeManyWithJsonArray(n)` |
+| JSON from already-existing model instances | `makeJsonObjectFromSingle(obj)` / `makeJsonArrayFromMany(list)` |
+| Edge-case variant (different fields, empty list, etc.) | define a named method returning `redefine()` / `redefineJson()` |
+
+## Commands
+
+```shell
+dart test                # run all tests
+dart test test/foo_test.dart  # run single test file
+dart analyze             # static analysis
+```
+
+## Architecture
+
+Pure Dart package — no Flutter dependency. Published to pub.dev as `data_fixture_dart`.
+
+### Layer responsibilities
+
+**Makers** (`lib/makers/`) — abstract interfaces only:
+- `FixtureMaker<Model>` — `makeSingle()`, `makeMany(int)`
+- `JsonFixtureMaker<Model>` extends above — adds JSON output methods
+
+**Definitions** (`lib/definitions/`) — concrete generation logic:
+- `FixtureDefinition<Model>` — holds a `FixtureDefinitionBuilder` (a `(Faker, [int index]) => Model` lambda) and a `Faker` instance; `makeMany` drives the lambda via `List.generate`, passing `index`
+- `JsonFixtureDefinition<Model>` — wraps a `FixtureDefinition` + a `JsonFixtureDefinitionBuilder` (`(Model, [int index]) => Map<String, dynamic>`); JSON generation always generates the model first, then maps it to JSON
+
+**Factories** (`lib/factories/`) — public API consumed by users:
+- `FixtureFactory<Model>` — abstract; users override `definition()` returning a `FixtureDefinition`. Provides `define()` (new definition) and `redefine()` (mutate result of `definition()`) helpers
+- `JsonFixtureFactory<Model>` extends `FixtureFactory` — users also override `jsonDefinition()`. Adds `defineJson()` and `redefineJson()` helpers
+
+**Misc** (`lib/misc/`):
+- `FixtureTuple<T>` — value object pairing `object` + `json`; returned by `makeSingleWithJsonObject()` / `makeManyWithJsonArray()`
+
+### Key design rules
+
+- `redefine()` calls `definition().definition(faker, index)` internally, then passes the result to the user's lambda — so partial overrides are cheap (just change the fields you care about).
+- `redefineJson()` reuses `jsonDefinition().jsonDefinition` (the builder), so JSON shape stays the same when you only want to change the model.
+- `index` is exposed to both builder lambdas so generated collections can have stable, predictable field values (e.g., sequential IDs in tests).
+- Custom `Faker` instances (with seed or custom providers) can be injected via the `faker:` named parameter on `define`/`redefine`.
+- The library re-exports `package:faker/faker.dart` so consumers only need one import.
+
+### Convention for test fixtures
+
+Factories are private (`_FooFixtureFactory`) and exposed via an extension method on the model:
+
+```dart
+extension FooFixture on Foo {
+  static _FooFixtureFactory factory() => _FooFixtureFactory();
+}
+```
+
+Custom definitions (e.g., `empty()`, `withFields()`) return `FixtureDefinition<Model>` or `JsonFixtureDefinition<Model>` so callers can chain directly into `makeSingle()` / `makeJsonObject()` etc.