Fix code snippets in integrations guides

[ArmandPhilippot]

Description (required)

Follow-up of #14089. TL;DR: Improve UX by preventing the appearance of red squiggles (TS) and visual changes (formatting with Astro extension) when the user copies and pastes a code snippet.

Formats and fixes code snippets in:

• integrations-guide/cloudflare.mdx:

  • In "Cloudflare Module Imports": this is a .js file, we can't use : any. And, we usually prefix the title with src/.

• integrations-guide/markdoc.mdx:

  • In multiple .astro snippets: entry can be undefined (once collection types are generated) and can't be used directly in render().
  • In "Create a custom Markdoc image tag": because src is ImageMetadata | string, we need the same typeof src === "string" check as in "Override Markdoc’s default image node".

• integrations-guide/mdx.mdx:

  • In "Using Exported Variables in MDX": TS complains because post is implicitly any. We need to add a type for it.
  • In "Passing components to MDX content": entry can be undefined (once collection types are generated) and can't be used directly in render()
  • In extendMarkdownConfig: missing fake imports
  • In ignoreElementNames: missing code snippet title, and we usually show components under src/components

• integrations-guide/partytown.mdx, both in "Proxying requests":

  • Missing imports
  • When using create-astro, the config file contains @ts-check. TypeScript complains about proxyMap[url.hostname]. And, because this is not a TS file, we can't use types. I see two options:
    • We could use a JSDoc comment with a type annotation. But I wonder if it could be confusing for some?
    • Use a Map instead of an object. Given browsers support, I don't think using Map is an issue. (my choice)

References

• Related to Fix TypeScript errors in "Configuration" & "Routing and navigation" code snippets #14089

[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

File	Note
en/guides/integrations-guide/cloudflare.mdx	Source changed, localizations will be marked as outdated.
en/guides/integrations-guide/markdoc.mdx	Source changed, localizations will be marked as outdated.
en/guides/integrations-guide/mdx.mdx	Source changed, localizations will be marked as outdated.
en/guides/integrations-guide/partytown.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.

[github-actions]

Preview deployment

✅ Deployment complete!

• Latest commit: a62df00
• Preview: https://armand-fix-code-snippets-integrations-guide.previews.docs.astro.build
• Workflow run: View logs