magic_devtools 0.0.7

Magic adapters for the fluttersdk dev-tooling ecosystem: wires MagicDuskIntegration and MagicTelescopeIntegration into dusk and telescope.

Changelog

All notable changes to this package are documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

0.0.7 - 2026-09-27

Changed

• Every sibling floor names this batch's release. magic moves ^0.0.16 to ^0.0.22, fluttersdk_dusk ^0.0.15 to ^0.0.16 and fluttersdk_wind ^1.6.3 to ^1.7.0; fluttersdk_telescope stays at ^0.0.7, still the newest. The old ranges already admitted the new versions, so a fresh pub get resolves nothing differently; what changes is that the floors name the releases this package is verified against. Of magic 0.0.22's BREAKING changes, the one that reaches this package is Auth.fake() dispatching AuthLogin/AuthLogout through the real Event facade, which only its tests call; the suite passes unchanged. dusk 0.0.16 stops dusk:fill/dusk:type/dusk:clear writing into a field on a covered route. (pubspec.yaml, README.md)

0.0.6 - 2026-09-22

Changed

• Every sibling floor names this batch's release. magic moves ^0.0.15 to ^0.0.16, fluttersdk_telescope ^0.0.6 to ^0.0.7 and fluttersdk_wind ^1.6.2 to ^1.6.3; fluttersdk_dusk stays at ^0.0.15, still the newest. The old ranges already admitted the new versions, so a fresh pub get resolves nothing differently; what changes is that the floors name the releases this package is verified against. telescope 0.0.7 is a documentation fix, and nothing in wind 1.6.3 or magic 0.0.16 touches an API this package calls. (pubspec.yaml, README.md)

0.0.5 - 2026-09-21

Changed

• Every sibling floor names this batch's release. magic moves ^0.0.7 to ^0.0.15, fluttersdk_dusk ^0.0.12 to ^0.0.15, fluttersdk_telescope ^0.0.5 to ^0.0.6 and fluttersdk_wind ^1.5.0 to ^1.6.2. The old ranges already admitted the new versions, so a fresh pub get resolves nothing differently; what changes is that the floors name the releases this package is verified against. magic 0.0.15 is breaking in its database layer (a migration may no longer manage its own transaction, and DB.transaction refuses a callback that closes the transaction itself); nothing in this package calls either, so no code here changes, but an app below magic 0.0.15 no longer resolves this release. (pubspec.yaml)

0.0.4 - 2026-08-25

Added

• MagicPerfIntegration: the wiring that assembles the performance-diagnostic data path across four packages. It sets MagicController.onRefreshUI to a counter keyed by controller runtime type, registers a NavigatorObserver through MagicRouter.addObserver that times each route push to the first post-frame callback after the new route builds, calls Wind.installPerfResolver(), registers telescope's FramePerfWatcher, and assigns the four fluttersdk_dusk pointers (framePerfReader, perfExtrasReader, perfSessionBeginHook, perfSessionEndHook). This package is the only place dusk, telescope, wind and magic are all visible at once, so it is the only place those pointers can be assigned; dusk declares them with no-op defaults and never imports the packages it reports on.
• MagicDevtools.installPre() now installs MagicPerfIntegration. It belongs in the pre-Magic.init() half because MagicRouter.addObserver throws once the router has been built, and that StateError is deliberately not caught: a silently unregistered observer would produce a report with no route transitions and nothing to explain their absence.

Changed

• The four sibling dependency floors now state what the code actually needs. They were magic: ^0.0.6, fluttersdk_dusk: ^0.0.9, fluttersdk_telescope: ^0.0.4 and fluttersdk_wind: ^1.2.1, and every one of them was below the release that introduced an API MagicPerfIntegration calls: MagicController.onRefreshUI arrived in magic 0.0.7, the four perf_readers.dart pointers in dusk 0.0.12, FramePerfWatcher and TelescopeStore.recentFramePerf / clearFramePerf in telescope 0.0.5, and WindPerfCounters with Wind.installPerfResolver() in wind 1.5.0.

  A caret range resolves to the newest version available, so a fresh resolution always picked up the right siblings and CI stayed green. A consumer whose own constraints hold one of them back would not: pub would report the graph as satisfiable and the build would then fail on undefined symbols. That is not hypothetical, it is what this branch's own CI did while ^1.2.1 was still resolving wind 1.4.1, with 18 errors all naming WindPerfCounters or installPerfResolver. Now ^0.0.7, ^0.0.12, ^0.0.5 and ^1.5.0.

0.0.3 - 2026-08-05

Documentation only; no runtime change. The package code is identical to 0.0.2.

Changed

• The README install snippet pins the versions actually shipped rather than a looser range, so a copy-paste resolves to the combination this package is tested against.
• .github/workflows/publish.yml names the pub.dev prerequisite it cannot check for itself. Automated publishing has to be enabled per package on pub.dev, and without it a tag gets all the way through validate, a clean --dry-run and the upload before pub.dev refuses; that is what left 0.0.2 unpublished for a week while consumers requiring ^0.0.2 could not resolve at all. That setting is still off, so this release was published by hand as well.

0.0.2 - 2026-07-29

Added

• MagicDevtools umbrella wiring: a new package:magic_devtools/magic_devtools.dart barrel exposing MagicDevtools.installPre() / MagicDevtools.installPost(). installPre boots both tool plugins and registers telescope's opt-in ExceptionWatcher + DumpWatcher (call before Magic.init()); installPost wires MagicTelescopeIntegration + MagicDuskIntegration (call after Magic.init()). Collapses the previous four kDebugMode blocks in a host's lib/main.dart into two, while preserving the load-bearing pre/post ordering and the call-site kDebugMode guard (moving the guard inside would defeat the release tree-shake).
• MagicPreview framework: a dev-only component preview catalog hosted via two plain pages (/preview and /preview/:component). New package:magic_devtools/preview.dart barrel exports the PreviewEntry contract (label, slug, builder), the MagicPreviewCatalog widget (a scrollable sidebar next to a SINGLE active preview pane — tapping a sidebar item, or deep-linking /preview/<slug>, swaps the pane to that entry; only the selected preview is mounted, so a large screen-heavy catalog stays responsive — plus a global light/dark toggle bound to wind's WindTheme.of(context).toggleTheme()), and the MagicPreview registration entrypoint (register plus registerRoutes). The route, catalog, and every registered PreviewEntry are reachable only through MagicPreview.registerRoutes, which is guarded by kReleaseMode plus const bool.fromEnvironment('PREVIEW_ENABLED', defaultValue: kDebugMode), so the whole surface const-folds dead and tree-shakes out of release builds. Entries are held in a function-scoped list (never a top-level const, the dart-lang/sdk#33920 foot-gun). The generated _previews.g.dart (Step 18) feeds a List<PreviewEntry> into MagicPreview.register. Consumers must call MagicPreview.registerRoutes() from a provider boot() BEFORE the router locks on first routerConfig access, else /preview silently never registers.
• fluttersdk_wind is now a direct dependency (the catalog renders on WDiv/WText/WAnchor and binds the theme toggle to WindThemeController).
• MagicDuskIntegration.install() now registers a navigate adapter via DuskPlugin.registerNavigateAdapter so ext.dusk.navigate --route <path> drives GoRouter through MagicRouter.instance.to(path) instead of falling back to the SystemNavigator platform broadcast. Returns true on success and false when the router is not yet initialised (catches StateError). resetForTesting() clears the adapter with DuskPlugin.registerNavigateAdapter(null).

Fixed

• /preview/<slug> deep links now select the right entry: the catalog moved off a persistent ShellRoute (which did not rebuild when only the child route swapped, leaving every deep link stuck on the first entry) to two plain pages; the /preview/:component builder receives the slug and rebuilds on navigation. Known dev-only limitation: feature-SCREEN previews (full controller-backed MagicStatefulViews) emit a couple of non-fatal setState() during build warnings because the catalog mounts the same screen in both the light and dark panes sharing a singleton controller; the screens render correctly and the real app routes are clean (the catalog is stripped from release).
• /preview route no longer crashes the app: the catalog group's index child path was / which composed to /preview/, tripping go_router's route path may not end with '/' assertion and blanking the entire app on every route. Changed the index child path to '' so the composed path is exactly /preview.
• Catalog previews now inherit the host theme: each light/dark pane copied a bare WindThemeData that carried no aliases, so component semantic tokens (text-fg, bg-surface, ...) resolved to no-ops and every preview rendered Flutter's red unstyled-text fallback. Panes now copyWith(brightness:) the ambient app theme, preserving aliases and brand colors.
• Catalog overflow: the preview surface now scrolls vertically and each pane scrolls horizontally, so wide variant matrices no longer trigger RenderFlex overflows in the side-by-side light/dark layout.

0.0.1 - 2026-06-17

Added

• Initial release, extracted from the magic package. MagicDuskIntegration (14 enrichers for fluttersdk_dusk snapshots) and MagicTelescopeIntegration (5 watchers plus MagicHttpFacadeAdapter for fluttersdk_telescope) now live here as a dedicated, debug-only dev-tooling adapter rather than as sub-barrels of magic.
• Two import barrels: package:magic_devtools/dusk.dart and package:magic_devtools/telescope.dart.
• The relocated enricher and watcher test suites moved over unchanged.

Note

• Local development resolves the magic, fluttersdk_dusk, and fluttersdk_telescope siblings through dependency_overrides path entries. Those overrides are dev-only; version pins replace them at publish (the publish-time pubspec is user-owned).