Skip to content

chore: deprecate legacy Builder API#3758

Open
bartlomieju wants to merge 2 commits intomainfrom
chore/deprecate-builder-api
Open

chore: deprecate legacy Builder API#3758
bartlomieju wants to merge 2 commits intomainfrom
chore/deprecate-builder-api

Conversation

@bartlomieju
Copy link
Copy Markdown
Member

Summary

  • Adds @deprecated JSDoc tags to all public exports from @fresh/core/dev (Builder, BuildOptions, ResolvedBuildConfig, OnTransformArgs, OnTransformOptions, TransformFn)
  • Adds @deprecated JSDoc tags to @fresh/plugin-tailwind and @fresh/plugin-tailwind-v3 exports
  • Updates --builder flag in @fresh/init help text to show "(Deprecated)"
  • Prints a warning when --builder flag is used during init

All deprecation notices point users to the Vite plugin as the replacement.

Closes #3635

Test plan

  • Verify IDE shows deprecation strikethrough on Builder, BuildOptions, etc. when imported from fresh/dev
  • Run deno run -A jsr:@fresh/init --builder . and verify deprecation warning is printed
  • Type checks pass

🤖 Generated with Claude Code

bartlomieju and others added 2 commits April 8, 2026 19:34
Adds @deprecated JSDoc tags to all public exports in:
- @fresh/core/dev (Builder, BuildOptions, ResolvedBuildConfig, etc.)
- @fresh/plugin-tailwind (tailwind function, TailwindPluginOptions)
- @fresh/plugin-tailwind-v3 (all exports)

Also marks the --builder flag in @fresh/init as deprecated in help
text and prints a warning when it's used.

Closes #3635

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Deprecation of the legacy Builder API

1 participant