refactor: remove dead code, unused API, and stale docs

[leoafarias]

Intent

Codebase-wide cleanup after the recent refactors. It removes code, API, dependencies, and files that nothing uses, and corrects docs and comments that are now false. There are two intentional exceptions:

• the default slide header no longer shows a leftover talk title
• unused public API is removed while 1.0.0 is still unreleased (pub.dev latest is 0.0.4)

Rebased on main after #122.

Commits

1. Playground editor leftovers: Command, a duplicate color util, per-file bookmark access (Dart and Swift), unused store APIs, DeckMarkdownCodec.encode, the unrendered deck-edit prompt, empty scaffolds, and editor-era comments.
2. PDF: the three copy-pasted wait loops become one _pollUntil.
3. superdeck: the route-authority doc comment moves to the method that implements it.
4. Unused code:
   • removed: MeasureSize, GoToSlideEvent, MarkdownRenderScope.of, unused Wizard widgets, and generation helpers
   • test helpers and fixtures nothing used
5. Dependencies and assets:
   • playground: gpt_markdown, golden_toolkit, and integration_test are removed; http moves to dev.
   • superdeck and builder: meta is removed.
   • superdeck: mocktail is removed, and iframe_template.html is no longer bundled.
6. Docs:
   • The quick-start const SuperDeckApp(options: DeckOptions()) examples did not compile.
   • The 1.0 migration notes called it "the next major" and said 1.x where they meant 0.x.
   • The changelog still named flutter_mermaid.
   • The Copilot instructions were stale.
7. Tooling config: removes the uninstalled custom_lint plugin, the unused lint_staged block, freezed globs, and stale ignore entries.
8. Shared analysis options now apply to every package. Five packages used an extends: key the analyzer ignores, so only cli applied the shared settings. Switching to include: surfaces no new issues.
9. Playground:
   • quick_agent/ becomes generation/, since it is the Wizard's generation engine.
   • Removed: validation codes nothing produces, the write-only open-deck state, and accessors and string wrappers only tests called.
   • Those tests now assert through what production exposes.
10. refactor! — unused public API (with changelog entries): aiSlideSchema, DeckWorkspace.projectDirectory, BlockInsets.authoringSchema, MarkdownAstConverter.toJson, SlideSerializer.serializeSlide, superDeckAspectRatio.
11. Test-only fields: usingTemplate, the duplicate ghost-suffix state, CachedImage.targetSize, and PdfController.disposed. savePdfWithFileSaverForTesting becomes savePdfWithFileSaver, since it is the production default.
12. fix(superdeck): untitled slides no longer show "Generative UI with Flutter" in the default header. Four ci-excluded goldens are updated.
13. test(superdeck): fails when the vendored Mermaid parser's upstream version differs from the resolved mermaid_core.
14. Duplicates: removes the cli tests that re-tested core's file extensions, and the unreferenced demo/showcase.md.
15. Docs links:
    • Package homepages and README links now point at conceptadev/superdeck.
    • navigation.mdx is added to the docs sidebar.
    • Docs no longer name the deleted MeasureSize.
    • AGENTS.md documents vendor/ directories.
16. Config: the melos pin now gives its real reason (it must match CI's melos-version), and .gitignore explicitly tracks the root lockfile.

Impacted packages

core, builder, cli, superdeck, plugins/pdf, playground, and demo, plus root tooling config and docs.

Commands run (on the rebased branch)

• fvm dart run melos bootstrap
• fvm dart run melos run build_runner:build --no-select: no generated-file drift
• fvm dart analyze --fatal-infos in all 7 packages, and on playground test_live: no issues
• fvm dart test (core, builder, cli) and fvm flutter test (superdeck, plugins/pdf, playground): all passing
• fvm dart run melos run contracts:check --no-select: schema up to date
• xcrun swiftc -parse on the changed Swift files: clean

Not run:

• the macOS app build and integration tests: both macOS runners target 10.15, which current Xcode rejects
• DCM: it needs a license, so dead code was found by reference tracing rather than DCM

Kept on purpose

• DeckPresentationState.isTransitioning and the convenience re-exports (DeckLoader, DeckPlugin, DeckWorkspace, DeckFormatException, and ack from core). These are API for consumers.
• ...ForTesting and @visibleForTesting seams, which are test seams rather than dead code.
• DeckCustomizationStore.level(). The tests have no other way to read resolved text styles without pumping widgets.
• generationBudget. It encodes the 30-second ceiling that the live smoke test asserts.
• The default footer text #superdeck.

Still open (needs a decision or tools we don't have here)

• macOS: the minimum window size (1200×700) needs a runtime check. The macOS deployment target of 10.15 also needs raising before any macOS build can run.
• DCM: packages/playground/dcm_baseline.json still suppresses about 468 findings. Clearing them needs a DCM license.
• URLs: documentation: URLs (docs.page/btwld), docs.json social links, image asset URLs, and the demo deck content still use btwld. GitHub redirects them.
• Empty decks: while a deck is empty, DeckPresentationState resets currentIndex to 0 even though the route keeps its slide.
• CLI tests: CommandX in cli has no direct tests. This predates this PR.

[github-actions]

Visit the preview URL for this PR (updated for commit 56297b2):

https://superdeck-dev--pr123-refactor-codebase-cl-55i0hmru.web.app

_{(expires Fri, 23 Oct 2026 00:41:26 GMT)}

_{🔥 via Firebase Hosting GitHub Action 🌎}

_{Sign: bd68fc230762285849207e7e120aaf87cd4ca2f9}