Feat/link card icon

[gxxxr-111]

Description

This PR implements the long-awaited icon support for the LinkCard component, as discussed in #970.

Currently, users have to duplicate the LinkCard source code locally to add icons. This PR provides a first-class, type-safe implementation that maintains consistency with the standard Card component.

Changes

• Component: Added icon and iconPlacement props to LinkCard.astro.
• Typing: Leveraged StarlightIcon for full type safety.
• Markdoc: Updated Markdoc schemas and synchronized test-d.ts to ensure parity.
• Docs: Added documentation and examples for the new props.

Relates to

• Fixes Support displaying an icon in `<LinkCard>` #970 (or "Addresses the feedback in Support displaying an icon in `<LinkCard>` #970")

[changeset-bot]

🦋 Changeset detected

Latest commit: 823b057

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 2 packages

Name	Type
@astrojs/starlight	Minor
@astrojs/starlight-markdoc	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[netlify]

✅ Deploy Preview for astro-starlight ready!

Name	Link
🔨 Latest commit	823b057
🔍 Latest deploy log	https://app.netlify.com/projects/astro-starlight/deploys/69eac230f9988f0008681d94
😎 Deploy Preview	https://deploy-preview-3788--astro-starlight.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.
Lighthouse	1 paths audited Performance: 100 (no change from production) Accessibility: 100 (no change from production) Best Practices: 100 (no change from production) SEO: 100 (no change from production) PWA: - View the detailed breakdown and full score reports

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[astrobot-houston]

Hello! Thank you for opening your first PR to Starlight! ✨

Here’s what will happen next:

1. Our GitHub bots will run to check your changes.
   If they spot any issues you will see some error messages on this PR.
   Don’t hesitate to ask any questions if you’re not sure what these mean!

2. In a few minutes, you’ll be able to see a preview of your changes on Netlify 🤩

3. One or more of our maintainers will take a look and may ask you to make changes.
   We try to be responsive, but don’t worry if this takes a few days.

[astrobot-houston]

Lunaria Status Overview

🌕 This pull request will trigger status changes.

Learn more

By default, every PR changing files present in the Lunaria configuration's files property will be considered and trigger status changes accordingly.

You can change this by adding one of the keywords present in the ignoreKeywords property in your Lunaria configuration file in the PR's title (ignoring all files) or by including a tracker directive in the merged commit's description.

Tracked Files

Locale	File	Note
en	components/link-cards.mdx	Source changed, localizations will be marked as outdated.

Warnings reference

Icon	Description
🔄️	The source for this localization has been updated since the creation of this pull request, make sure all changes in the source have been applied.

[trueberryless]

Thank you for your amazing first contribution to Starlight 🥳

I really like your changes and I am mostly happy with them. I just left two small comments regarding documentation and the changelog.

One more general thing however: It seems that in the discussion about this feature, people expected the icon to replace the right arrow, so I wonder if two icons would be too confusing. One idea would be to replace the right arrow when iconPlacement is set to "end", however I assume this would feel unintuitive and inconsistent to the user.

Maybe we should further discuss this in the discussion until a clear path for the feature is decided. Nonetheless, this seems like a decently upvoted discussion, so thank you for getting the ball rolling on this feature 🚀

I also am not a maintainer, and therefore, I don't know if they want that such a feature waits until we support custom icons. But from my side, this feature is not affected by custom icons. 👍

[gxxxr-111]

Thanks for the feedback! I've applied the suggested changes to the docs and changeset. Regarding the icon/arrow coexistence, I've started a quick follow-up in the original discussion #970 (comment) to see what the community prefers. I'll update the PR once we have a clearer path!