feat(icons): add Icon suffix to all icons and deprecate old names

[rektdeckard]

After considering the request in #104 to add the "Icon" prefix to all icon components to aid readability in JSX and to not pollute the scope with common names, I have decided that doing something like this is worthwhile. After playing around with it I landed on using the suffix form, e.g.:

import { UserIcon } from "@phosphor-icons/react";

These are now the primary names for icon components exported from the library. The original names are still exported but are marked as deprecated, pointing users to the new suffixed name:

The filenames have not changed to reflect this, for two reasons:

1. We are trying our best not to increase bundle size, and enev 4 characters adds up with over 4500 files to rename.
2. We do not want to break any fully-qualified imports.

We also should now have better support in some edge cases for Next.js by way of better disambiguation between es and cjs exports.

I will publish this under the next tag on NPM for testing until confident in these changes.

[rektdeckard]

Seems to work fine in a few demos:

• React 19 + Vite
• Next.js + React 18

[slk333]

Thanks for working on this.

The request on #104 was for a prefix. Can you explain why you prefer a suffix?

Thanks!

[rektdeckard]

Because one philosophy at Phosphor is to do things as simply as possible. If you'd call it a User icon in conversation, UserIcon makes the most sense. And because I liked it better.

I believe this strongly addresses 2 of the 3 issues OP has with naming, and more or less addresses the third. Sorry if you don't get the exact autocomplete behavior you were looking for 🤷‍♂️.

[jovana]

I have upgraded to the latest version and noticed the deprecation message. I also came across this topic.
It seems the example website/documentation has not been updated yet.

Could you please share the timeline for when the old names will no longer be supported?

[rektdeckard]

Answered in #104

[knownasilya]

With this change TextBolder is no longer available in the deprecated format, only as TextBolderIcon. Accidental breaking change?

[rektdeckard]

@knownasilya that's a mistake, yes. I'll check for other legacy names and push an update. text-bolder itself has been deprecated in favor of text-b since 2.0, I assume that's the source of the issue.

[lxk-jreckner]

It looks like Activity was missed on the other legacy names check. It's only available as ActivityIcon as well, similar to #127 (comment) about TextBolder