From 970cbc02a3577843700e7522bc8bb462ebc6ca51 Mon Sep 17 00:00:00 2001
From: Pierre-Olivier Mercier <nemunaire@nemunai.re>
Date: Sat, 6 Jun 2026 17:14:41 +0900
Subject: [PATCH] bimi: suggest declination record when no valid BIMI record is
 found
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Show an informational tip with a ready-to-copy declination record
(§4.3.1 of draft-brand-indicators-for-message-identification) so users
who do not intend to publish a logo can explicitly opt out and prevent
mail clients from falling back to a parent-domain record.
---
 .../lib/components/BimiRecordDisplay.svelte   | 20 +++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/web/src/lib/components/BimiRecordDisplay.svelte b/web/src/lib/components/BimiRecordDisplay.svelte
index 889e24f..8d21b1f 100644
--- a/web/src/lib/components/BimiRecordDisplay.svelte
+++ b/web/src/lib/components/BimiRecordDisplay.svelte
@@ -72,6 +72,26 @@
                     {bimiRecord.error}
                 </div>
             {/if}
+            {#if !bimiRecord.valid}
+                <div class="alert alert-info mt-3 mb-0">
+                    <h6 class="alert-heading">
+                        <i class="bi bi-lightbulb me-1"></i>
+                        Explicitly decline BIMI participation
+                    </h6>
+                    <p class="mb-2 small">
+                        If you do not intend to publish a brand logo, you can add a declination
+                        record to signal that this domain deliberately opts out of BIMI. This
+                        prevents mail clients from falling back to a parent-domain record:
+                    </p>
+                    <code class="d-block bg-white rounded p-2 text-break border"
+                        >{bimiRecord.selector}._bimi.{bimiRecord.domain}. IN TXT "v=BIMI1; l=; a="</code
+                    >
+                    <p class="mt-1 mb-0 small text-muted">
+                        Declination record format as defined in §&thinsp;4.3.1 of
+                        <em>draft-brand-indicators-for-message-identification</em>.
+                    </p>
+                </div>
+            {/if}
         </div>
     </div>
 {/if}