fix(types): add referrerPolicy to ImgHTMLAttributes

[civing]

What is the current behavior?

JSXBase.ImgHTMLAttributes is missing the referrerPolicy attribute, so this fails type-checking:

<img src="https://example.com/icon.png" referrerPolicy="no-referrer" />
// Property 'referrerPolicy' does not exist on type
// 'ImgHTMLAttributes<HTMLImageElement>'.

Consumers have to cast as any to compile, which is noisy and obscures intent. The attribute already exists on the sibling JSX types AnchorHTMLAttributes and IframeHTMLAttributes.

GitHub Issue Number: #6692

What is the new behavior?

Adds referrerPolicy?: ReferrerPolicy; to ImgHTMLAttributes in src/declarations/stencil-public-runtime.ts, mirroring the existing declarations on AnchorHTMLAttributes (line 1056) and IframeHTMLAttributes (line 1191). The ReferrerPolicy type is provided by the TypeScript DOM lib; no additional imports and no runtime impact, since this only affects JSX type checking.

This brings <img> in line with the HTML spec and matches prior fixes for the same gap on sibling elements:

• <iframe>: fix(jsx): add referrerPolicy for iframe interface #2003 (2020) — fix(jsx): add referrerPolicy for iframe interface
• <a>: Add referrerPolicy to AnchorHTMLAttributes #3006 (2021) — fix(types): add referrerPolicy to AnchorHTMLAttributes

Documentation

N/A — JSX type addition.

Does this introduce a breaking change?

• Yes
• No

Testing

• npm run build succeeds.
• Following the precedent of fix(jsx): add referrerPolicy for iframe interface #2003 and Add referrerPolicy to AnchorHTMLAttributes #3006, no test was added — both prior PRs were single-line declaration additions with no accompanying tests, since the change has no runtime behavior to exercise.

Other information

Real-world motivation: a CRM web-components library needs referrerpolicy="no-referrer" on rendered <img> to suppress the Referer header when the image source is a third-party favicon service, so the originating CRM page URL doesn't leak to the third party.

[Copilot]

Pull request overview

Adds the missing referrerPolicy JSX typing to Stencil’s <img> attributes so consumers can set referrerPolicy="no-referrer" (and related values) without any casts, matching existing support on <a> and <iframe>.

Changes:

• Add referrerPolicy?: ReferrerPolicy; to JSXBase.ImgHTMLAttributes.
• Align <img> JSX typings with the existing referrerPolicy declarations already present for AnchorHTMLAttributes and IframeHTMLAttributes.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.