<\/div>\s*
+
+ )}
{/* package runtimes (body-end, module). Astro bundles }
diff --git a/packages/sitetile/astro/src/lib/inbox-bubble.mjs b/packages/sitetile/astro/src/lib/inbox-bubble.mjs
new file mode 100644
index 0000000..1c7997e
--- /dev/null
+++ b/packages/sitetile/astro/src/lib/inbox-bubble.mjs
@@ -0,0 +1,27 @@
+const OFF = /^(off|false|no|0)$/i;
+const ON = /^(on|true|yes|1)$/i;
+
+export function localeAgnosticPath(pathname, locales = []) {
+ const path = `/${String(pathname || '/').split(/[?#]/)[0].replace(/^\/+|\/+$/g, '')}`;
+ const first = path.split('/')[1].toLowerCase();
+ const localeSet = new Set(locales.map((v) => String(v).trim().toLowerCase()));
+ return localeSet.has(first) ? (path.slice(first.length + 1) || '/') : path;
+}
+
+export function pathMatches(pattern, pathname) {
+ const p = String(pattern || '').trim();
+ if (!p) return false;
+ return p.endsWith('*') ? pathname.startsWith(p.slice(0, -1)) : pathname === p;
+}
+
+export function inboxBubbleOn(meta = {}, pathname = '/', renderedBody = '') {
+ if (renderedBody.includes('data-dynamic-coral="inbox-bubble"')) return false;
+ const raw = String(meta['inbox-bubble'] ?? 'on').trim();
+ if (OFF.test(raw)) return false;
+ if (ON.test(raw) && Object.prototype.hasOwnProperty.call(meta, 'inbox-bubble-page-override')) return true;
+ const locales = String(meta.locales || '').split(',').map((v) => v.trim()).filter(Boolean);
+ const path = localeAgnosticPath(pathname, locales);
+ const excluded = String(meta['inbox-bubble-except'] || '').split(',').some((p) => pathMatches(p, path));
+ return !excluded;
+}
+
diff --git a/packages/sitetile/astro/src/pages/[...path].astro b/packages/sitetile/astro/src/pages/[...path].astro
index b03a113..cb9208f 100644
--- a/packages/sitetile/astro/src/pages/[...path].astro
+++ b/packages/sitetile/astro/src/pages/[...path].astro
@@ -78,6 +78,9 @@ export function getStaticPaths() {
// blog-search etc. consistent across ALL pages instead of each page duplicating the chrome.
const site = parseSite(raw);
const siteConfig = loadSite(files, rel);
+ // Reserved resolution marker: after Site ⊕ page both values look identical, but the layout
+ // must know that an explicit page `on` wins over the site's exclusion patterns.
+ if (Object.prototype.hasOwnProperty.call(site.meta, 'inbox-bubble')) site.meta['inbox-bubble-page-override'] = true;
// 🩸 `site-title` is stashed BEFORE the merge because the merge destroys the distinction the
// head needs. og:site_name must be a constant per site, but it was reading headerBrand, which
// falls back to meta.title — and after this merge meta.title is the PAGE's title on any page
diff --git a/packages/sitetile/inbox-bubble.test.mjs b/packages/sitetile/inbox-bubble.test.mjs
new file mode 100644
index 0000000..381b23e
--- /dev/null
+++ b/packages/sitetile/inbox-bubble.test.mjs
@@ -0,0 +1,19 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { inboxBubbleOn, localeAgnosticPath, pathMatches } from './astro/src/lib/inbox-bubble.mjs';
+
+test('inbox bubble defaults on and obeys site off', () => {
+ assert.equal(inboxBubbleOn({}, '/'), true);
+ assert.equal(inboxBubbleOn({ 'inbox-bubble': 'off' }, '/'), false);
+});
+
+test('suffix patterns are locale agnostic', () => {
+ assert.equal(localeAgnosticPath('/zh-tw/shop/item', ['en-US', 'zh-TW']), '/shop/item');
+ assert.equal(pathMatches('/shop/*', '/shop/item'), true);
+ assert.equal(inboxBubbleOn({ locales: 'en-US, zh-TW', 'inbox-bubble-except': '/shop/*' }, '/zh-tw/shop/item'), false);
+});
+
+test('a hand-mounted bubble is deduped', () => {
+ assert.equal(inboxBubbleOn({}, '/', '
'), false);
+});
+
diff --git a/packages/sitetile/site-core.js b/packages/sitetile/site-core.js
index dfcf746..c7e8608 100644
--- a/packages/sitetile/site-core.js
+++ b/packages/sitetile/site-core.js
@@ -43,6 +43,12 @@ import { highlightCode, knowsLanguage } from '../cssmd/highlight.js';
const FRONTMATTER_KEY = 'sitetile-page';
const KNOWN_TYPES = ['prose', 'hero', 'grid', 'gallery', 'carousel', 'cta', 'embed', 'collection', 'timeline', 'social', 'tagcloud', 'faq', 'form', 'people'];
+// Site-layer vocabulary exported beside KNOWN_TYPES so grammar vendors have one renderer-owned
+// source of truth for chrome keys that are otherwise invisible to the section model.
+const SITE_LAYER_KEYS = [
+ { key: 'inbox-bubble', syntax: 'inbox-bubble: on | off', purpose: 'Show the site visitor Q&A/message bubble on every page by default; a page value overrides the site value.' },
+ { key: 'inbox-bubble-except', syntax: 'inbox-bubble-except: /shop/*, /checkout', purpose: 'Comma-separated locale-agnostic paths to suppress the bubble; a trailing * matches any suffix.' },
+];
// tagcloudLinks: a tagcloud section body (a markdown list of `- [Label](/href)` items) → an
// ordered [{label, href}]. General — a weighted category/tag cloud is a near-universal WP/Blogger
@@ -1500,6 +1506,6 @@ export {
heroParts, socialParts, linkButtonsHtml, firstImage, imgTag, tagcloudLinks,
// sidebar layout helpers — exported so the Astro layer can reuse the same parser.
parseSidebarNav,
- FRONTMATTER_KEY, KNOWN_TYPES,
+ FRONTMATTER_KEY, KNOWN_TYPES, SITE_LAYER_KEYS,
deriveDescription, DESC_MAX,
};