@wix/web5-core 1.57.2 → 1.59.0

package/dist/cjs/utils/matchDebug.js

@@ -0,0 +1,93 @@
+"use strict";
+
+exports.__esModule = true;
+exports.setMatchDebug = exports.resetMatchDebugCache = exports.logMatchDebug = exports.isMatchDebugEnabled = exports.MATCH_DEBUG_QUERY_PARAM = exports.MATCH_DEBUG_KEY = void 0;
+/**
+ * Section-match tracing (debug-only).
+ *
+ * Turns the otherwise silent matching loop in `tryParseComponent` into a
+ * console trace: which definitions the active registry holds and in what
+ * order, which patterns were tried against a block, why each one failed, and
+ * when a matching definition then returned `null` from `parse()` and let the
+ * block fall through to the next candidate.
+ *
+ * Answers the two questions a "my section isn't rendering" report always
+ * splits into — *is my definition even registered?* (a missing entry in the
+ * registry order line usually means a stale bundle or a `web5-core` version
+ * skew; see the warning in `ComponentRegistry.register`) and *did it lose the
+ * match, or lose the parse?*
+ *
+ * Off by default. Enable with `?web5DebugMatch=1` (one-shot, wins over
+ * storage) or `localStorage["web5_debug_match"] = "1"` (sticky). Resolved once
+ * per page load — the tracing is on the hot parse path, so it must not read
+ * storage per block.
+ */
+
+const MATCH_DEBUG_KEY = exports.MATCH_DEBUG_KEY = 'web5_debug_match';
+
+/** Query param that forces match tracing on, overriding localStorage. */
+const MATCH_DEBUG_QUERY_PARAM = exports.MATCH_DEBUG_QUERY_PARAM = 'web5DebugMatch';
+const LOG_PREFIX = '[web5:match]';
+const isTruthy = value => value === '1' || value === 'true';
+let cached = null;
+
+/**
+ * Whether match tracing is enabled. Memoized: the parse loop calls this for
+ * every block of every turn.
+ */
+const isMatchDebugEnabled = () => {
+  if (cached !== null) {
+    return cached;
+  }
+  cached = false;
+  try {
+    if (isTruthy(new URLSearchParams(window.location.search).get(MATCH_DEBUG_QUERY_PARAM))) {
+      cached = true;
+      return cached;
+    }
+  } catch {
+    // window / URLSearchParams unavailable (SSR, non-DOM environments).
+  }
+  try {
+    cached = isTruthy(localStorage.getItem(MATCH_DEBUG_KEY));
+  } catch {
+    // localStorage can throw in privacy mode / non-DOM environments.
+  }
+  return cached;
+};
+
+/** Persist the toggle and apply it to the current page without a reload. */
+exports.isMatchDebugEnabled = isMatchDebugEnabled;
+const setMatchDebug = enabled => {
+  cached = enabled;
+  try {
+    if (enabled) {
+      localStorage.setItem(MATCH_DEBUG_KEY, '1');
+    } else {
+      localStorage.removeItem(MATCH_DEBUG_KEY);
+    }
+  } catch {
+    // Ignore — the toggle simply won't persist across reloads.
+  }
+};
+
+/** Drop the memoized value (tests, and after an external storage change). */
+exports.setMatchDebug = setMatchDebug;
+const resetMatchDebugCache = () => {
+  cached = null;
+};
+
+/**
+ * Log one trace line. Callers must gate on {@link isMatchDebugEnabled} before
+ * building expensive messages; this only guards the write.
+ */
+exports.resetMatchDebugCache = resetMatchDebugCache;
+const logMatchDebug = message => {
+  if (!isMatchDebugEnabled()) {
+    return;
+  }
+  // eslint-disable-next-line no-console
+  console.log(`${LOG_PREFIX} ${message}`);
+};
+exports.logMatchDebug = logMatchDebug;
+//# sourceMappingURL=matchDebug.js.map

package/dist/cjs/utils/matchDebug.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["MATCH_DEBUG_KEY","exports","MATCH_DEBUG_QUERY_PARAM","LOG_PREFIX","isTruthy","value","cached","isMatchDebugEnabled","URLSearchParams","window","location","search","get","localStorage","getItem","setMatchDebug","enabled","setItem","removeItem","resetMatchDebugCache","logMatchDebug","message","console","log"],"sources":["../../../src/utils/matchDebug.ts"],"sourcesContent":["/**\n * Section-match tracing (debug-only).\n *\n * Turns the otherwise silent matching loop in `tryParseComponent` into a\n * console trace: which definitions the active registry holds and in what\n * order, which patterns were tried against a block, why each one failed, and\n * when a matching definition then returned `null` from `parse()` and let the\n * block fall through to the next candidate.\n *\n * Answers the two questions a \"my section isn't rendering\" report always\n * splits into — *is my definition even registered?* (a missing entry in the\n * registry order line usually means a stale bundle or a `web5-core` version\n * skew; see the warning in `ComponentRegistry.register`) and *did it lose the\n * match, or lose the parse?*\n *\n * Off by default. Enable with `?web5DebugMatch=1` (one-shot, wins over\n * storage) or `localStorage[\"web5_debug_match\"] = \"1\"` (sticky). Resolved once\n * per page load — the tracing is on the hot parse path, so it must not read\n * storage per block.\n */\n\nexport const MATCH_DEBUG_KEY = 'web5_debug_match';\n\n/** Query param that forces match tracing on, overriding localStorage. */\nexport const MATCH_DEBUG_QUERY_PARAM = 'web5DebugMatch';\n\nconst LOG_PREFIX = '[web5:match]';\n\nconst isTruthy = (value: unknown): boolean => value === '1' || value === 'true';\n\nlet cached: boolean | null = null;\n\n/**\n * Whether match tracing is enabled. Memoized: the parse loop calls this for\n * every block of every turn.\n */\nexport const isMatchDebugEnabled = (): boolean => {\n  if (cached !== null) {\n    return cached;\n  }\n  cached = false;\n  try {\n    if (\n      isTruthy(\n        new URLSearchParams(window.location.search).get(\n          MATCH_DEBUG_QUERY_PARAM,\n        ),\n      )\n    ) {\n      cached = true;\n      return cached;\n    }\n  } catch {\n    // window / URLSearchParams unavailable (SSR, non-DOM environments).\n  }\n  try {\n    cached = isTruthy(localStorage.getItem(MATCH_DEBUG_KEY));\n  } catch {\n    // localStorage can throw in privacy mode / non-DOM environments.\n  }\n  return cached;\n};\n\n/** Persist the toggle and apply it to the current page without a reload. */\nexport const setMatchDebug = (enabled: boolean): void => {\n  cached = enabled;\n  try {\n    if (enabled) {\n      localStorage.setItem(MATCH_DEBUG_KEY, '1');\n    } else {\n      localStorage.removeItem(MATCH_DEBUG_KEY);\n    }\n  } catch {\n    // Ignore — the toggle simply won't persist across reloads.\n  }\n};\n\n/** Drop the memoized value (tests, and after an external storage change). */\nexport const resetMatchDebugCache = (): void => {\n  cached = null;\n};\n\n/**\n * Log one trace line. Callers must gate on {@link isMatchDebugEnabled} before\n * building expensive messages; this only guards the write.\n */\nexport const logMatchDebug = (message: string): void => {\n  if (!isMatchDebugEnabled()) {\n    return;\n  }\n  // eslint-disable-next-line no-console\n  console.log(`${LOG_PREFIX} ${message}`);\n};\n"],"mappings":";;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEO,MAAMA,eAAe,GAAAC,OAAA,CAAAD,eAAA,GAAG,kBAAkB;;AAEjD;AACO,MAAME,uBAAuB,GAAAD,OAAA,CAAAC,uBAAA,GAAG,gBAAgB;AAEvD,MAAMC,UAAU,GAAG,cAAc;AAEjC,MAAMC,QAAQ,GAAIC,KAAc,IAAcA,KAAK,KAAK,GAAG,IAAIA,KAAK,KAAK,MAAM;AAE/E,IAAIC,MAAsB,GAAG,IAAI;;AAEjC;AACA;AACA;AACA;AACO,MAAMC,mBAAmB,GAAGA,CAAA,KAAe;EAChD,IAAID,MAAM,KAAK,IAAI,EAAE;IACnB,OAAOA,MAAM;EACf;EACAA,MAAM,GAAG,KAAK;EACd,IAAI;IACF,IACEF,QAAQ,CACN,IAAII,eAAe,CAACC,MAAM,CAACC,QAAQ,CAACC,MAAM,CAAC,CAACC,GAAG,CAC7CV,uBACF,CACF,CAAC,EACD;MACAI,MAAM,GAAG,IAAI;MACb,OAAOA,MAAM;IACf;EACF,CAAC,CAAC,MAAM;IACN;EAAA;EAEF,IAAI;IACFA,MAAM,GAAGF,QAAQ,CAACS,YAAY,CAACC,OAAO,CAACd,eAAe,CAAC,CAAC;EAC1D,CAAC,CAAC,MAAM;IACN;EAAA;EAEF,OAAOM,MAAM;AACf,CAAC;;AAED;AAAAL,OAAA,CAAAM,mBAAA,GAAAA,mBAAA;AACO,MAAMQ,aAAa,GAAIC,OAAgB,IAAW;EACvDV,MAAM,GAAGU,OAAO;EAChB,IAAI;IACF,IAAIA,OAAO,EAAE;MACXH,YAAY,CAACI,OAAO,CAACjB,eAAe,EAAE,GAAG,CAAC;IAC5C,CAAC,MAAM;MACLa,YAAY,CAACK,UAAU,CAAClB,eAAe,CAAC;IAC1C;EACF,CAAC,CAAC,MAAM;IACN;EAAA;AAEJ,CAAC;;AAED;AAAAC,OAAA,CAAAc,aAAA,GAAAA,aAAA;AACO,MAAMI,oBAAoB,GAAGA,CAAA,KAAY;EAC9Cb,MAAM,GAAG,IAAI;AACf,CAAC;;AAED;AACA;AACA;AACA;AAHAL,OAAA,CAAAkB,oBAAA,GAAAA,oBAAA;AAIO,MAAMC,aAAa,GAAIC,OAAe,IAAW;EACtD,IAAI,CAACd,mBAAmB,CAAC,CAAC,EAAE;IAC1B;EACF;EACA;EACAe,OAAO,CAACC,GAAG,CAAC,GAAGpB,UAAU,IAAIkB,OAAO,EAAE,CAAC;AACzC,CAAC;AAACpB,OAAA,CAAAmB,aAAA,GAAAA,aAAA","ignoreList":[]}

package/dist/esm/client/applyThemeOverrides.js

@@ -0,0 +1,85 @@
+/**
+ * Runtime theme token injection (DL #131).
+ *
+ * `Configuration.themeOverrides` carries per-store CSS custom-property
+ * overrides (`--primary`, `--radius`, `--heading`, ...) computed from the
+ * store's own theme (e.g. the Shopify `settings_data.json` extractor). This
+ * applies them to the page so they win over the bundle's baked `theme.css`:
+ *
+ * - **Scoped, not `:root`**: the rule targets `WEB5_SCOPE`, the same
+ *   `:is(#root, .w5-root, [data-web5-placement], .debug-view)` selector every
+ *   compiled bundle stylesheet uses — host-page styling is never touched, and
+ *   equal specificity + later document order makes the override win. Callers
+ *   must therefore apply AFTER the client bundle's CSS is in the document.
+ * - **Open token set**: any sanely-shaped custom property is applied, so a
+ *   template can grow new tokens without an FE or BE release. The mandatory
+ *   `--` prefix means an override can only define custom properties — it can
+ *   never set a real CSS property inside the scope. The server enforces the
+ *   same shape (plus value sanitation) at write time.
+ * - **Values are inert**: entries are written with
+ *   `CSSStyleDeclaration.setProperty`, never string-concatenated into CSS, so
+ *   a hostile value cannot terminate the declaration or open a new rule.
+ * - **Idempotent**: one marker element per document, replaced wholesale on
+ *   re-apply; empty/absent input removes it.
+ */
+import { WEB5_SCOPE } from '../hostScope.js';
+
+/** A themeOverrides key: always a CSS custom property. */
+
+/**
+ * Writer-side shape for a theme override map. The catalog below documents
+ * the tokens the seed consumes today; the type stays open so new tokens
+ * flow end-to-end with no release anywhere but the seed.
+ */
+
+/**
+ * The known token catalog — the CSS custom properties the seed's Tailwind
+ * bridge consumes today. GUIDANCE, NOT A GATE: writers (the Shopify theme
+ * extractor, admin tooling) should stick to these to produce visible effect,
+ * but `applyThemeOverrides` deliberately applies any well-formed custom
+ * property so the vocabulary can grow from the seed alone (matching the
+ * open-set validation on the server).
+ */
+export const THEME_OVERRIDE_TOKENS = new Set(['--background', '--foreground', '--card', '--card-foreground', '--popover', '--popover-foreground', '--primary', '--primary-foreground', '--secondary', '--secondary-foreground', '--muted', '--muted-foreground', '--accent', '--accent-foreground', '--border', '--input', '--ring', '--radius', '--font-sans', '--font-display', '--heading']);
+
+/** Mirrors the server's Consts.ThemeOverrideKeyPattern. */
+const KEY_PATTERN = /^--[a-z][a-z0-9-]{0,62}$/;
+const MARKER_ATTR = 'data-web5-theme-overrides';
+export function applyThemeOverrides(overrides) {
+  if (typeof document === 'undefined') return;
+  const existing = document.head.querySelector(`style[${MARKER_ATTR}]`);
+  const entries = Object.entries(overrides ?? {}).filter(_ref => {
+    let [key] = _ref;
+    const wellFormed = KEY_PATTERN.test(key);
+    if (!wellFormed) {
+      console.warn(`[web5-theme] Skipping malformed theme override key: ${key}`);
+    }
+    return wellFormed;
+  });
+  if (entries.length === 0) {
+    existing == null || existing.remove();
+    return;
+  }
+  const style = document.createElement('style');
+  style.setAttribute(MARKER_ATTR, '');
+  document.head.appendChild(style);
+  const sheet = style.sheet;
+  if (!sheet) {
+    style.remove();
+    return;
+  }
+  sheet.insertRule(`${WEB5_SCOPE} {}`, 0);
+  const rule = sheet.cssRules[0];
+  for (const [key, value] of entries) {
+    try {
+      rule.style.setProperty(key, value);
+    } catch {
+      // An engine that rejects the value leaves the token at its baked
+      // default — degraded theming, never broken CSS.
+    }
+  }
+  // Replace-on-reapply: the fresh element is appended (so it stays last in
+  // document order) before the stale one is dropped.
+  existing == null || existing.remove();
+}
+//# sourceMappingURL=applyThemeOverrides.js.map

package/dist/esm/client/applyThemeOverrides.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["WEB5_SCOPE","THEME_OVERRIDE_TOKENS","Set","KEY_PATTERN","MARKER_ATTR","applyThemeOverrides","overrides","document","existing","head","querySelector","entries","Object","filter","_ref","key","wellFormed","test","console","warn","length","remove","style","createElement","setAttribute","appendChild","sheet","insertRule","rule","cssRules","value","setProperty"],"sources":["../../../src/client/applyThemeOverrides.ts"],"sourcesContent":["/**\n * Runtime theme token injection (DL #131).\n *\n * `Configuration.themeOverrides` carries per-store CSS custom-property\n * overrides (`--primary`, `--radius`, `--heading`, ...) computed from the\n * store's own theme (e.g. the Shopify `settings_data.json` extractor). This\n * applies them to the page so they win over the bundle's baked `theme.css`:\n *\n * - **Scoped, not `:root`**: the rule targets `WEB5_SCOPE`, the same\n *   `:is(#root, .w5-root, [data-web5-placement], .debug-view)` selector every\n *   compiled bundle stylesheet uses — host-page styling is never touched, and\n *   equal specificity + later document order makes the override win. Callers\n *   must therefore apply AFTER the client bundle's CSS is in the document.\n * - **Open token set**: any sanely-shaped custom property is applied, so a\n *   template can grow new tokens without an FE or BE release. The mandatory\n *   `--` prefix means an override can only define custom properties — it can\n *   never set a real CSS property inside the scope. The server enforces the\n *   same shape (plus value sanitation) at write time.\n * - **Values are inert**: entries are written with\n *   `CSSStyleDeclaration.setProperty`, never string-concatenated into CSS, so\n *   a hostile value cannot terminate the declaration or open a new rule.\n * - **Idempotent**: one marker element per document, replaced wholesale on\n *   re-apply; empty/absent input removes it.\n */\nimport { WEB5_SCOPE } from '../hostScope';\n\n/** A themeOverrides key: always a CSS custom property. */\nexport type ThemeOverrideKey = `--${string}`;\n\n/**\n * Writer-side shape for a theme override map. The catalog below documents\n * the tokens the seed consumes today; the type stays open so new tokens\n * flow end-to-end with no release anywhere but the seed.\n */\nexport type ThemeOverrides = Record<ThemeOverrideKey, string>;\n\n/**\n * The known token catalog — the CSS custom properties the seed's Tailwind\n * bridge consumes today. GUIDANCE, NOT A GATE: writers (the Shopify theme\n * extractor, admin tooling) should stick to these to produce visible effect,\n * but `applyThemeOverrides` deliberately applies any well-formed custom\n * property so the vocabulary can grow from the seed alone (matching the\n * open-set validation on the server).\n */\nexport const THEME_OVERRIDE_TOKENS: ReadonlySet<string> = new Set([\n  '--background', '--foreground',\n  '--card', '--card-foreground',\n  '--popover', '--popover-foreground',\n  '--primary', '--primary-foreground',\n  '--secondary', '--secondary-foreground',\n  '--muted', '--muted-foreground',\n  '--accent', '--accent-foreground',\n  '--border', '--input', '--ring',\n  '--radius',\n  '--font-sans', '--font-display',\n  '--heading',\n]);\n\n/** Mirrors the server's Consts.ThemeOverrideKeyPattern. */\nconst KEY_PATTERN = /^--[a-z][a-z0-9-]{0,62}$/;\n\nconst MARKER_ATTR = 'data-web5-theme-overrides';\n\nexport function applyThemeOverrides(\n  overrides?: Record<string, string> | null,\n): void {\n  if (typeof document === 'undefined') return;\n\n  const existing = document.head.querySelector(`style[${MARKER_ATTR}]`);\n  const entries = Object.entries(overrides ?? {}).filter(([key]) => {\n    const wellFormed = KEY_PATTERN.test(key);\n    if (!wellFormed) {\n      console.warn(`[web5-theme] Skipping malformed theme override key: ${key}`);\n    }\n    return wellFormed;\n  });\n\n  if (entries.length === 0) {\n    existing?.remove();\n    return;\n  }\n\n  const style = document.createElement('style');\n  style.setAttribute(MARKER_ATTR, '');\n  document.head.appendChild(style);\n  const sheet = style.sheet;\n  if (!sheet) {\n    style.remove();\n    return;\n  }\n  sheet.insertRule(`${WEB5_SCOPE} {}`, 0);\n  const rule = sheet.cssRules[0] as CSSStyleRule;\n  for (const [key, value] of entries) {\n    try {\n      rule.style.setProperty(key, value);\n    } catch {\n      // An engine that rejects the value leaves the token at its baked\n      // default — degraded theming, never broken CSS.\n    }\n  }\n  // Replace-on-reapply: the fresh element is appended (so it stays last in\n  // document order) before the stale one is dropped.\n  existing?.remove();\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASA,UAAU,QAAQ,cAAc;;AAEzC;;AAGA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,qBAA0C,GAAG,IAAIC,GAAG,CAAC,CAChE,cAAc,EAAE,cAAc,EAC9B,QAAQ,EAAE,mBAAmB,EAC7B,WAAW,EAAE,sBAAsB,EACnC,WAAW,EAAE,sBAAsB,EACnC,aAAa,EAAE,wBAAwB,EACvC,SAAS,EAAE,oBAAoB,EAC/B,UAAU,EAAE,qBAAqB,EACjC,UAAU,EAAE,SAAS,EAAE,QAAQ,EAC/B,UAAU,EACV,aAAa,EAAE,gBAAgB,EAC/B,WAAW,CACZ,CAAC;;AAEF;AACA,MAAMC,WAAW,GAAG,0BAA0B;AAE9C,MAAMC,WAAW,GAAG,2BAA2B;AAE/C,OAAO,SAASC,mBAAmBA,CACjCC,SAAyC,EACnC;EACN,IAAI,OAAOC,QAAQ,KAAK,WAAW,EAAE;EAErC,MAAMC,QAAQ,GAAGD,QAAQ,CAACE,IAAI,CAACC,aAAa,CAAC,SAASN,WAAW,GAAG,CAAC;EACrE,MAAMO,OAAO,GAAGC,MAAM,CAACD,OAAO,CAACL,SAAS,IAAI,CAAC,CAAC,CAAC,CAACO,MAAM,CAACC,IAAA,IAAW;IAAA,IAAV,CAACC,GAAG,CAAC,GAAAD,IAAA;IAC3D,MAAME,UAAU,GAAGb,WAAW,CAACc,IAAI,CAACF,GAAG,CAAC;IACxC,IAAI,CAACC,UAAU,EAAE;MACfE,OAAO,CAACC,IAAI,CAAC,uDAAuDJ,GAAG,EAAE,CAAC;IAC5E;IACA,OAAOC,UAAU;EACnB,CAAC,CAAC;EAEF,IAAIL,OAAO,CAACS,MAAM,KAAK,CAAC,EAAE;IACxBZ,QAAQ,YAARA,QAAQ,CAAEa,MAAM,CAAC,CAAC;IAClB;EACF;EAEA,MAAMC,KAAK,GAAGf,QAAQ,CAACgB,aAAa,CAAC,OAAO,CAAC;EAC7CD,KAAK,CAACE,YAAY,CAACpB,WAAW,EAAE,EAAE,CAAC;EACnCG,QAAQ,CAACE,IAAI,CAACgB,WAAW,CAACH,KAAK,CAAC;EAChC,MAAMI,KAAK,GAAGJ,KAAK,CAACI,KAAK;EACzB,IAAI,CAACA,KAAK,EAAE;IACVJ,KAAK,CAACD,MAAM,CAAC,CAAC;IACd;EACF;EACAK,KAAK,CAACC,UAAU,CAAC,GAAG3B,UAAU,KAAK,EAAE,CAAC,CAAC;EACvC,MAAM4B,IAAI,GAAGF,KAAK,CAACG,QAAQ,CAAC,CAAC,CAAiB;EAC9C,KAAK,MAAM,CAACd,GAAG,EAAEe,KAAK,CAAC,IAAInB,OAAO,EAAE;IAClC,IAAI;MACFiB,IAAI,CAACN,KAAK,CAACS,WAAW,CAAChB,GAAG,EAAEe,KAAK,CAAC;IACpC,CAAC,CAAC,MAAM;MACN;MACA;IAAA;EAEJ;EACA;EACA;EACAtB,QAAQ,YAARA,QAAQ,CAAEa,MAAM,CAAC,CAAC;AACpB","ignoreList":[]}

package/dist/esm/client/clientBundleUrl.js

@@ -0,0 +1,75 @@
+/**
+ * Client-UMD URL resolution, shared between `web50-server-ui` (the main app)
+ * and `embed-placement` (the storefront widget) — DL #094 (per-msid) + DL #129
+ * (per-template). Centralized here for the same reason as
+ * `clientBundleOverride.ts`: both callers must derive identical URLs, and
+ * divergence on which bundle a tenant executes would be a real bug.
+ *
+ * Two tiers (DL #129):
+ *   - `templateId` present (DIY store) → the shared per-template bundle,
+ *     `<cdn>/templates/<id>/production/…`. Every store on a template runs the
+ *     same artifact; `production` is the promoted channel.
+ *   - `templateId` absent (customized tier: feature-com, circana, smallflower)
+ *     → the per-msid bundle at `<cdn>/<msid>/latest/…`, byte-identical to the
+ *     pre-template behavior.
+ */
+
+const CLIENT_BUNDLE_CDN = 'https://d13cktzsgh0qls.cloudfront.net';
+const CLIENT_BUNDLE_FILENAME = 'w5-components.umd.js';
+
+/**
+ * The template catalog the onboarding gallery and the preview picker render —
+ * published by web5-seed-1's CI (`templates/manifest.json` + previews),
+ * CORS-open. Thumbnail paths inside are relative to `TEMPLATES_CDN_BASE`.
+ */
+export const TEMPLATES_CDN_BASE = `${CLIENT_BUNDLE_CDN}/templates`;
+export const TEMPLATES_MANIFEST_URL = `${TEMPLATES_CDN_BASE}/manifest.json`;
+
+/**
+ * Template ids are kebab-case slugs from `templates/manifest.json`
+ * (`web5-seed-1`). The id becomes a CDN path segment, so anything else is a
+ * config error — resolve falls back to the per-msid path (fail-soft, and the
+ * store keeps rendering) rather than fetching a malformed URL.
+ */
+const TEMPLATE_ID_PATTERN = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+export function isValidTemplateId(id) {
+  return id.length <= 64 && TEMPLATE_ID_PATTERN.test(id);
+}
+
+/**
+ * `?web5Template=<id>` — client-side template override (DL #129 Q10), the
+ * mechanism behind the live-preview picker: reload with the param and the page
+ * renders under that template's shared bundle, no Configuration write.
+ *
+ * Strictly narrower than `?clientBundleUrl=`: the value is a kebab-validated
+ * id interpolated into the fixed CDN template prefix, so it can only ever
+ * select one of our own template bundles — purely presentational, harmless if
+ * a visitor sets it by hand. Precedence at the call sites:
+ * `clientBundleUrl` override > this > `Configuration.templateId`.
+ */
+export function getTemplateOverride(search) {
+  const value = new URLSearchParams(search).get('web5Template');
+  if (!value) {
+    return null;
+  }
+  if (!isValidTemplateId(value)) {
+    console.warn(`[web5-core] Ignoring malformed ?web5Template= override "${value}".`);
+    return null;
+  }
+  return value;
+}
+
+/** `?web5TemplatePicker=1` — should the preview picker overlay render? */
+export function isTemplatePickerRequested(search) {
+  return new URLSearchParams(search).get('web5TemplatePicker') === '1';
+}
+export function resolveClientBundleUrl(msid, templateId) {
+  if (templateId) {
+    if (TEMPLATE_ID_PATTERN.test(templateId)) {
+      return `${CLIENT_BUNDLE_CDN}/templates/${templateId}/production/${CLIENT_BUNDLE_FILENAME}`;
+    }
+    console.warn(`[web5-core] Ignoring malformed templateId "${templateId}" — falling back to the per-msid bundle.`);
+  }
+  return `${CLIENT_BUNDLE_CDN}/${msid}/latest/${CLIENT_BUNDLE_FILENAME}`;
+}
+//# sourceMappingURL=clientBundleUrl.js.map

package/dist/esm/client/clientBundleUrl.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["CLIENT_BUNDLE_CDN","CLIENT_BUNDLE_FILENAME","TEMPLATES_CDN_BASE","TEMPLATES_MANIFEST_URL","TEMPLATE_ID_PATTERN","isValidTemplateId","id","length","test","getTemplateOverride","search","value","URLSearchParams","get","console","warn","isTemplatePickerRequested","resolveClientBundleUrl","msid","templateId"],"sources":["../../../src/client/clientBundleUrl.ts"],"sourcesContent":["/**\n * Client-UMD URL resolution, shared between `web50-server-ui` (the main app)\n * and `embed-placement` (the storefront widget) — DL #094 (per-msid) + DL #129\n * (per-template). Centralized here for the same reason as\n * `clientBundleOverride.ts`: both callers must derive identical URLs, and\n * divergence on which bundle a tenant executes would be a real bug.\n *\n * Two tiers (DL #129):\n *   - `templateId` present (DIY store) → the shared per-template bundle,\n *     `<cdn>/templates/<id>/production/…`. Every store on a template runs the\n *     same artifact; `production` is the promoted channel.\n *   - `templateId` absent (customized tier: feature-com, circana, smallflower)\n *     → the per-msid bundle at `<cdn>/<msid>/latest/…`, byte-identical to the\n *     pre-template behavior.\n */\n\nconst CLIENT_BUNDLE_CDN = 'https://d13cktzsgh0qls.cloudfront.net';\nconst CLIENT_BUNDLE_FILENAME = 'w5-components.umd.js';\n\n/**\n * The template catalog the onboarding gallery and the preview picker render —\n * published by web5-seed-1's CI (`templates/manifest.json` + previews),\n * CORS-open. Thumbnail paths inside are relative to `TEMPLATES_CDN_BASE`.\n */\nexport const TEMPLATES_CDN_BASE = `${CLIENT_BUNDLE_CDN}/templates`;\nexport const TEMPLATES_MANIFEST_URL = `${TEMPLATES_CDN_BASE}/manifest.json`;\n\n/**\n * Template ids are kebab-case slugs from `templates/manifest.json`\n * (`web5-seed-1`). The id becomes a CDN path segment, so anything else is a\n * config error — resolve falls back to the per-msid path (fail-soft, and the\n * store keeps rendering) rather than fetching a malformed URL.\n */\nconst TEMPLATE_ID_PATTERN = /^[a-z0-9]+(-[a-z0-9]+)*$/;\n\nexport function isValidTemplateId(id: string): boolean {\n  return id.length <= 64 && TEMPLATE_ID_PATTERN.test(id);\n}\n\n/**\n * `?web5Template=<id>` — client-side template override (DL #129 Q10), the\n * mechanism behind the live-preview picker: reload with the param and the page\n * renders under that template's shared bundle, no Configuration write.\n *\n * Strictly narrower than `?clientBundleUrl=`: the value is a kebab-validated\n * id interpolated into the fixed CDN template prefix, so it can only ever\n * select one of our own template bundles — purely presentational, harmless if\n * a visitor sets it by hand. Precedence at the call sites:\n * `clientBundleUrl` override > this > `Configuration.templateId`.\n */\nexport function getTemplateOverride(search: string): string | null {\n  const value = new URLSearchParams(search).get('web5Template');\n  if (!value) {\n    return null;\n  }\n  if (!isValidTemplateId(value)) {\n    console.warn(\n      `[web5-core] Ignoring malformed ?web5Template= override \"${value}\".`,\n    );\n    return null;\n  }\n  return value;\n}\n\n/** `?web5TemplatePicker=1` — should the preview picker overlay render? */\nexport function isTemplatePickerRequested(search: string): boolean {\n  return new URLSearchParams(search).get('web5TemplatePicker') === '1';\n}\n\nexport function resolveClientBundleUrl(\n  msid: string,\n  templateId?: string | null,\n): string {\n  if (templateId) {\n    if (TEMPLATE_ID_PATTERN.test(templateId)) {\n      return `${CLIENT_BUNDLE_CDN}/templates/${templateId}/production/${CLIENT_BUNDLE_FILENAME}`;\n    }\n    console.warn(\n      `[web5-core] Ignoring malformed templateId \"${templateId}\" — falling back to the per-msid bundle.`,\n    );\n  }\n  return `${CLIENT_BUNDLE_CDN}/${msid}/latest/${CLIENT_BUNDLE_FILENAME}`;\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,MAAMA,iBAAiB,GAAG,uCAAuC;AACjE,MAAMC,sBAAsB,GAAG,sBAAsB;;AAErD;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,kBAAkB,GAAG,GAAGF,iBAAiB,YAAY;AAClE,OAAO,MAAMG,sBAAsB,GAAG,GAAGD,kBAAkB,gBAAgB;;AAE3E;AACA;AACA;AACA;AACA;AACA;AACA,MAAME,mBAAmB,GAAG,0BAA0B;AAEtD,OAAO,SAASC,iBAAiBA,CAACC,EAAU,EAAW;EACrD,OAAOA,EAAE,CAACC,MAAM,IAAI,EAAE,IAAIH,mBAAmB,CAACI,IAAI,CAACF,EAAE,CAAC;AACxD;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASG,mBAAmBA,CAACC,MAAc,EAAiB;EACjE,MAAMC,KAAK,GAAG,IAAIC,eAAe,CAACF,MAAM,CAAC,CAACG,GAAG,CAAC,cAAc,CAAC;EAC7D,IAAI,CAACF,KAAK,EAAE;IACV,OAAO,IAAI;EACb;EACA,IAAI,CAACN,iBAAiB,CAACM,KAAK,CAAC,EAAE;IAC7BG,OAAO,CAACC,IAAI,CACV,2DAA2DJ,KAAK,IAClE,CAAC;IACD,OAAO,IAAI;EACb;EACA,OAAOA,KAAK;AACd;;AAEA;AACA,OAAO,SAASK,yBAAyBA,CAACN,MAAc,EAAW;EACjE,OAAO,IAAIE,eAAe,CAACF,MAAM,CAAC,CAACG,GAAG,CAAC,oBAAoB,CAAC,KAAK,GAAG;AACtE;AAEA,OAAO,SAASI,sBAAsBA,CACpCC,IAAY,EACZC,UAA0B,EAClB;EACR,IAAIA,UAAU,EAAE;IACd,IAAIf,mBAAmB,CAACI,IAAI,CAACW,UAAU,CAAC,EAAE;MACxC,OAAO,GAAGnB,iBAAiB,cAAcmB,UAAU,eAAelB,sBAAsB,EAAE;IAC5F;IACAa,OAAO,CAACC,IAAI,CACV,8CAA8CI,UAAU,0CAC1D,CAAC;EACH;EACA,OAAO,GAAGnB,iBAAiB,IAAIkB,IAAI,WAAWjB,sBAAsB,EAAE;AACxE","ignoreList":[]}

package/dist/esm/client/mergeClientConfig.js

@@ -0,0 +1,55 @@
+/**
+ * Universal client-config merge (DL #129 Q3/Q7): the loaded client bundle's
+ * `clientConfig` is the default; the backend `Configuration.clientConfig`
+ * overrides it **per field, only where a field was actually returned**.
+ *
+ * One rule for both tiers, shared between `web50-server-ui` and
+ * `embed-placement` (the two places that load `w5-components.umd.js`):
+ *   - Customized-tier clients (feature-com, circana): the backend returns no
+ *     `clientConfig`, so the merge is identity — the bundle's baked config
+ *     passes through byte-identical (same reference, see spec).
+ *   - DIY/template stores: the backend supplies per-store deltas that grow
+ *     field-by-field as the client-config port (Phase 3b) lands; each ported
+ *     field takes effect here with no FE change.
+ *
+ * Semantics — presence, not truthiness:
+ *   - The wire omits unset proto fields, so key-absence means "not returned"
+ *     → bundle value kept. A key that IS present wins even when falsy
+ *     (`''`, `false`, `0`) — it was explicitly set.
+ *   - `undefined`/`null` values are treated as absent (proto3 JSON never
+ *     emits null for wrapper types; defensive against hand-written configs).
+ *   - Plain objects merge per leaf; arrays replace wholesale; class
+ *     instances / functions replace wholesale.
+ */
+
+function isPlainObject(value) {
+  return typeof value === 'object' && value !== null && !Array.isArray(value) && (Object.getPrototypeOf(value) === Object.prototype || Object.getPrototypeOf(value) === null);
+}
+export function mergeClientConfig(bundleConfig,
+// `Record<string, unknown>` admitted alongside `DeepPartial<T>`: the wire
+// value is untyped JSON (`Configuration.clientConfig`), so callers hold it
+// as a plain record — the runtime presence checks do the validation.
+backendConfig) {
+  if (backendConfig === undefined || backendConfig === null) {
+    return bundleConfig;
+  }
+  if (!isPlainObject(backendConfig)) {
+    return bundleConfig;
+  }
+  const keys = Object.keys(backendConfig).filter(key => backendConfig[key] !== undefined && backendConfig[key] !== null);
+  // Empty delta → identity, same reference: the byte-identical passthrough
+  // guarantee for clients whose Configuration carries no clientConfig.
+  if (keys.length === 0) {
+    return bundleConfig;
+  }
+  const result = {
+    ...bundleConfig
+  };
+  for (const key of keys) {
+    const backendValue = backendConfig[key];
+    const bundleValue = bundleConfig[key];
+    result[key] = isPlainObject(backendValue) && isPlainObject(bundleValue) ? mergeClientConfig(bundleValue, backendValue) : backendValue;
+  }
+  return result;
+}
+//# sourceMappingURL=mergeClientConfig.js.map

package/dist/esm/client/mergeClientConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isPlainObject","value","Array","isArray","Object","getPrototypeOf","prototype","mergeClientConfig","bundleConfig","backendConfig","undefined","keys","filter","key","length","result","backendValue","bundleValue"],"sources":["../../../src/client/mergeClientConfig.ts"],"sourcesContent":["/**\n * Universal client-config merge (DL #129 Q3/Q7): the loaded client bundle's\n * `clientConfig` is the default; the backend `Configuration.clientConfig`\n * overrides it **per field, only where a field was actually returned**.\n *\n * One rule for both tiers, shared between `web50-server-ui` and\n * `embed-placement` (the two places that load `w5-components.umd.js`):\n *   - Customized-tier clients (feature-com, circana): the backend returns no\n *     `clientConfig`, so the merge is identity — the bundle's baked config\n *     passes through byte-identical (same reference, see spec).\n *   - DIY/template stores: the backend supplies per-store deltas that grow\n *     field-by-field as the client-config port (Phase 3b) lands; each ported\n *     field takes effect here with no FE change.\n *\n * Semantics — presence, not truthiness:\n *   - The wire omits unset proto fields, so key-absence means \"not returned\"\n *     → bundle value kept. A key that IS present wins even when falsy\n *     (`''`, `false`, `0`) — it was explicitly set.\n *   - `undefined`/`null` values are treated as absent (proto3 JSON never\n *     emits null for wrapper types; defensive against hand-written configs).\n *   - Plain objects merge per leaf; arrays replace wholesale; class\n *     instances / functions replace wholesale.\n */\n\nexport type DeepPartial<T> = T extends (infer U)[]\n  ? U[]\n  : T extends object\n    ? { [K in keyof T]?: DeepPartial<T[K]> }\n    : T;\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    !Array.isArray(value) &&\n    (Object.getPrototypeOf(value) === Object.prototype ||\n      Object.getPrototypeOf(value) === null)\n  );\n}\n\nexport function mergeClientConfig<T extends object>(\n  bundleConfig: T,\n  // `Record<string, unknown>` admitted alongside `DeepPartial<T>`: the wire\n  // value is untyped JSON (`Configuration.clientConfig`), so callers hold it\n  // as a plain record — the runtime presence checks do the validation.\n  backendConfig?: DeepPartial<T> | Record<string, unknown> | null,\n): T {\n  if (backendConfig === undefined || backendConfig === null) {\n    return bundleConfig;\n  }\n  if (!isPlainObject(backendConfig)) {\n    return bundleConfig;\n  }\n  const keys = Object.keys(backendConfig).filter(\n    (key) => (backendConfig as Record<string, unknown>)[key] !== undefined &&\n      (backendConfig as Record<string, unknown>)[key] !== null,\n  );\n  // Empty delta → identity, same reference: the byte-identical passthrough\n  // guarantee for clients whose Configuration carries no clientConfig.\n  if (keys.length === 0) {\n    return bundleConfig;\n  }\n\n  const result: Record<string, unknown> = {\n    ...(bundleConfig as Record<string, unknown>),\n  };\n  for (const key of keys) {\n    const backendValue = (backendConfig as Record<string, unknown>)[key];\n    const bundleValue = (bundleConfig as Record<string, unknown>)[key];\n    result[key] =\n      isPlainObject(backendValue) && isPlainObject(bundleValue)\n        ? mergeClientConfig(bundleValue, backendValue)\n        : backendValue;\n  }\n  return result as T;\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAQA,SAASA,aAAaA,CAACC,KAAc,EAAoC;EACvE,OACE,OAAOA,KAAK,KAAK,QAAQ,IACzBA,KAAK,KAAK,IAAI,IACd,CAACC,KAAK,CAACC,OAAO,CAACF,KAAK,CAAC,KACpBG,MAAM,CAACC,cAAc,CAACJ,KAAK,CAAC,KAAKG,MAAM,CAACE,SAAS,IAChDF,MAAM,CAACC,cAAc,CAACJ,KAAK,CAAC,KAAK,IAAI,CAAC;AAE5C;AAEA,OAAO,SAASM,iBAAiBA,CAC/BC,YAAe;AACf;AACA;AACA;AACAC,aAA+D,EAC5D;EACH,IAAIA,aAAa,KAAKC,SAAS,IAAID,aAAa,KAAK,IAAI,EAAE;IACzD,OAAOD,YAAY;EACrB;EACA,IAAI,CAACR,aAAa,CAACS,aAAa,CAAC,EAAE;IACjC,OAAOD,YAAY;EACrB;EACA,MAAMG,IAAI,GAAGP,MAAM,CAACO,IAAI,CAACF,aAAa,CAAC,CAACG,MAAM,CAC3CC,GAAG,IAAMJ,aAAa,CAA6BI,GAAG,CAAC,KAAKH,SAAS,IACnED,aAAa,CAA6BI,GAAG,CAAC,KAAK,IACxD,CAAC;EACD;EACA;EACA,IAAIF,IAAI,CAACG,MAAM,KAAK,CAAC,EAAE;IACrB,OAAON,YAAY;EACrB;EAEA,MAAMO,MAA+B,GAAG;IACtC,GAAIP;EACN,CAAC;EACD,KAAK,MAAMK,GAAG,IAAIF,IAAI,EAAE;IACtB,MAAMK,YAAY,GAAIP,aAAa,CAA6BI,GAAG,CAAC;IACpE,MAAMI,WAAW,GAAIT,YAAY,CAA6BK,GAAG,CAAC;IAClEE,MAAM,CAACF,GAAG,CAAC,GACTb,aAAa,CAACgB,YAAY,CAAC,IAAIhB,aAAa,CAACiB,WAAW,CAAC,GACrDV,iBAAiB,CAACU,WAAW,EAAED,YAAY,CAAC,GAC5CA,YAAY;EACpB;EACA,OAAOD,MAAM;AACf","ignoreList":[]}

package/dist/esm/component/componentDefinitions/EntityCollectionSectionDefinition.js

@@ -0,0 +1,154 @@
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+import { headingText, entitySectionBodyText, extractEntityRefs, calloutFromParts } from './parse-utils.js';
+import { DIAGNOSTIC_TYPES } from '../diagnosticTypes.js';
+
+/**
+ * The semantic entity type this definition claims — the `<type>` segment of
+ * `web5://entity/<type>/<id>` (see the client `entityConfig.entityTypes` map).
+ */
+const COLLECTION_ENTITY_TYPE = 'collection';
+
+/**
+ * Entity section restricted to **collection** entities
+ * (`web5://entity/collection/<id>`).
+ *
+ * Same markdown shapes as {@link EntitySectionDefinition} — an `h2`, optional
+ * intro/callout, then entity links either at the top level or as list items —
+ * but every entity link must be a collection. That makes it a strictly narrower
+ * match, so it MUST be registered **before** `EntitySectionDefinition` (which
+ * claims any `link[entityType]`, i.e. product and article sections too). Once
+ * `EntitySectionDefinition` matches, the block is consumed and no later
+ * definition is consulted.
+ *
+ * Mixed blocks (a collection next to a product or an article) fall through:
+ * the patterns only cover consecutive collection links, and `parse()` returns
+ * `null` when a non-collection entity slipped into the matched slice, handing
+ * the block to `EntitySectionDefinition`.
+ *
+ * Props are the shared {@link EntityCompProps} shape, so a client renders it
+ * with a dedicated `EntityCollectionSection` component while product/article
+ * sections keep using their own components under `EntitySectionDefinition`.
+ */
+export class EntityCollectionSectionDefinition {
+  constructor() {
+    _defineProperty(this, "sectionType", 'entityCollection');
+    /**
+     * One pattern, matching the shape the orchestrator actually emits for a
+     * collections block:
+     *
+     *   <!-- section:entities, semantic:items -->
+     *   ## Curated collections by theme
+     *   - [](web5://entity/collection/<id>) description
+     *
+     * The head absorbs the section descriptor and any intro copy or ECHO
+     * callout; each list item is a collection link, an optional markdown image,
+     * then its description and optional per-item callout. A trailing
+     * section-level callout is intentionally left outside the pattern so it
+     * falls through to the downstream CalloutSection.
+     *
+     * Deliberately narrow: anything else (collection links at the top level
+     * rather than in a list, a block mixing entity types) falls through to
+     * `EntitySectionDefinition`, which is what handled it before this
+     * definition existed.
+     */
+    _defineProperty(this, "patterns", ['html_comment* > h2 > (html_comment | t | callout)* > list{item[1-]:link[entityType="collection"] > image? > (t | callout)*}']);
+    _defineProperty(this, "defaults", {
+      title: 'Collections',
+      items: [{
+        entityId: 'example-1',
+        entityType: COLLECTION_ENTITY_TYPE,
+        entityUrl: 'web5://entity/collection/example-1',
+        linkText: 'Example collection'
+      }]
+    });
+    _defineProperty(this, "fixtures", [{
+      markdown: '## Shop the collections\n\nCurated edits for the season.\n\n- [Running](web5://entity/collection/pUx3mVQ1TmyN2mVYQqQ8Jg) Shoes and kit built for the road\n- [Trail](web5://entity/collection/Rr8kQyO0S1uH2nQ0mQ2AqQ) Grip and protection off-road',
+      expected: {
+        title: 'Shop the collections',
+        description: 'Curated edits for the season.',
+        items: [{
+          entityId: 'pUx3mVQ1TmyN2mVYQqQ8Jg',
+          entityType: 'collection',
+          entityUrl: 'web5://entity/collection/pUx3mVQ1TmyN2mVYQqQ8Jg',
+          linkText: 'Running',
+          description: 'Shoes and kit built for the road'
+        }, {
+          entityId: 'Rr8kQyO0S1uH2nQ0mQ2AqQ',
+          entityType: 'collection',
+          entityUrl: 'web5://entity/collection/Rr8kQyO0S1uH2nQ0mQ2AqQ',
+          linkText: 'Trail',
+          description: 'Grip and protection off-road'
+        }]
+      }
+    }, {
+      // The shape the orchestrator emits: a section descriptor, empty link
+      // text, and a Shopify gid (which is itself a `://` url) as the entity id.
+      markdown: '<!-- section:entities, semantic:items -->\n## Curated collections by theme\n- [](web5://entity/collection/gid://shopify/Collection/347895267466) storewide assortment spanning the full product range\n- [](web5://entity/collection/gid://shopify/Collection/348001501322) artistic **Watercolor** candles with bright vessels',
+      expected: {
+        title: 'Curated collections by theme',
+        items: [{
+          entityId: 'gid://shopify/Collection/347895267466',
+          entityType: 'collection',
+          entityUrl: 'web5://entity/collection/gid://shopify/Collection/347895267466',
+          description: 'storewide assortment spanning the full product range'
+        }, {
+          entityId: 'gid://shopify/Collection/348001501322',
+          entityType: 'collection',
+          entityUrl: 'web5://entity/collection/gid://shopify/Collection/348001501322',
+          // Inline emphasis survives — descriptions keep their markdown.
+          description: 'artistic **Watercolor** candles with bright vessels'
+        }]
+      }
+    }, {
+      // Single collection — the full-width banner shape.
+      markdown: '## Winter essentials\n\n- [Shop winter](web5://entity/collection/aB1cD2eF3gH4iJ5kL6mN7o) Layers for the cold months',
+      expected: {
+        title: 'Winter essentials',
+        items: [{
+          entityId: 'aB1cD2eF3gH4iJ5kL6mN7o',
+          entityType: 'collection',
+          entityUrl: 'web5://entity/collection/aB1cD2eF3gH4iJ5kL6mN7o',
+          linkText: 'Shop winter',
+          description: 'Layers for the cold months'
+        }]
+      }
+    }]);
+  }
+  parse(parts, context) {
+    const entityRefs = extractEntityRefs(parts);
+    if (entityRefs.length === 0) {
+      context == null || context.reportDiagnostic == null || context.reportDiagnostic(DIAGNOSTIC_TYPES.SECTION_REJECTED, 'entityCollection: no entity links found');
+      return null;
+    }
+
+    // Guard the pattern: anything that is not a collection means this block
+    // belongs to the generic entity section, not here.
+    if (entityRefs.some(e => e.entityType !== COLLECTION_ENTITY_TYPE)) {
+      context == null || context.reportDiagnostic == null || context.reportDiagnostic(DIAGNOSTIC_TYPES.SECTION_REJECTED, 'entityCollection: block mixes collections with other entity types');
+      return null;
+    }
+    const title = headingText(parts, 2) || 'Collections';
+    const description = entitySectionBodyText(parts) || undefined;
+
+    // Every entity link lives inside the list, so any top-level callout is
+    // section-level by construction — per-item callouts are nested in the list
+    // items and are picked up by extractEntityRefs instead.
+    const callout = calloutFromParts(parts);
+    const items = entityRefs.map(e => ({
+      entityId: e.entityId,
+      entityType: e.entityType,
+      entityUrl: e.entityUrl,
+      linkText: e.linkText || undefined,
+      description: e.description || undefined,
+      imageUrl: e.markdownImageUrl,
+      callout: e.callout
+    }));
+    return {
+      title,
+      description,
+      callout,
+      items
+    };
+  }
+}
+//# sourceMappingURL=EntityCollectionSectionDefinition.js.map

package/dist/esm/component/componentDefinitions/EntityCollectionSectionDefinition.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["headingText","entitySectionBodyText","extractEntityRefs","calloutFromParts","DIAGNOSTIC_TYPES","COLLECTION_ENTITY_TYPE","EntityCollectionSectionDefinition","constructor","_defineProperty","title","items","entityId","entityType","entityUrl","linkText","markdown","expected","description","parse","parts","context","entityRefs","length","reportDiagnostic","SECTION_REJECTED","some","e","undefined","callout","map","imageUrl","markdownImageUrl"],"sources":["../../../../src/component/componentDefinitions/EntityCollectionSectionDefinition.ts"],"sourcesContent":["import {\n  headingText,\n  entitySectionBodyText,\n  extractEntityRefs,\n  calloutFromParts,\n} from './parse-utils';\nimport type { Part } from '../../parts/parts';\nimport type {\n  EntityCompProps,\n  EntityItem,\n  EntitySectionComponent,\n  SectionFixture,\n} from '../types';\nimport type { SectionDefinition, ParseContext } from '../section-definition';\nimport { DIAGNOSTIC_TYPES } from '../diagnosticTypes';\n\n/**\n * The semantic entity type this definition claims — the `<type>` segment of\n * `web5://entity/<type>/<id>` (see the client `entityConfig.entityTypes` map).\n */\nconst COLLECTION_ENTITY_TYPE = 'collection';\n\n/**\n * Entity section restricted to **collection** entities\n * (`web5://entity/collection/<id>`).\n *\n * Same markdown shapes as {@link EntitySectionDefinition} — an `h2`, optional\n * intro/callout, then entity links either at the top level or as list items —\n * but every entity link must be a collection. That makes it a strictly narrower\n * match, so it MUST be registered **before** `EntitySectionDefinition` (which\n * claims any `link[entityType]`, i.e. product and article sections too). Once\n * `EntitySectionDefinition` matches, the block is consumed and no later\n * definition is consulted.\n *\n * Mixed blocks (a collection next to a product or an article) fall through:\n * the patterns only cover consecutive collection links, and `parse()` returns\n * `null` when a non-collection entity slipped into the matched slice, handing\n * the block to `EntitySectionDefinition`.\n *\n * Props are the shared {@link EntityCompProps} shape, so a client renders it\n * with a dedicated `EntityCollectionSection` component while product/article\n * sections keep using their own components under `EntitySectionDefinition`.\n */\nexport class EntityCollectionSectionDefinition\n  implements SectionDefinition<EntitySectionComponent>\n{\n  sectionType = 'entityCollection' as const;\n  /**\n   * One pattern, matching the shape the orchestrator actually emits for a\n   * collections block:\n   *\n   *   <!-- section:entities, semantic:items -->\n   *   ## Curated collections by theme\n   *   - [](web5://entity/collection/<id>) description\n   *\n   * The head absorbs the section descriptor and any intro copy or ECHO\n   * callout; each list item is a collection link, an optional markdown image,\n   * then its description and optional per-item callout. A trailing\n   * section-level callout is intentionally left outside the pattern so it\n   * falls through to the downstream CalloutSection.\n   *\n   * Deliberately narrow: anything else (collection links at the top level\n   * rather than in a list, a block mixing entity types) falls through to\n   * `EntitySectionDefinition`, which is what handled it before this\n   * definition existed.\n   */\n  patterns = [\n    'html_comment* > h2 > (html_comment | t | callout)* > list{item[1-]:link[entityType=\"collection\"] > image? > (t | callout)*}',\n  ];\n\n  defaults: EntityCompProps = {\n    title: 'Collections',\n    items: [\n      {\n        entityId: 'example-1',\n        entityType: COLLECTION_ENTITY_TYPE,\n        entityUrl: 'web5://entity/collection/example-1',\n        linkText: 'Example collection',\n      },\n    ],\n  };\n\n  fixtures: SectionFixture<EntityCompProps>[] = [\n    {\n      markdown:\n        '## Shop the collections\\n\\nCurated edits for the season.\\n\\n- [Running](web5://entity/collection/pUx3mVQ1TmyN2mVYQqQ8Jg) Shoes and kit built for the road\\n- [Trail](web5://entity/collection/Rr8kQyO0S1uH2nQ0mQ2AqQ) Grip and protection off-road',\n      expected: {\n        title: 'Shop the collections',\n        description: 'Curated edits for the season.',\n        items: [\n          {\n            entityId: 'pUx3mVQ1TmyN2mVYQqQ8Jg',\n            entityType: 'collection',\n            entityUrl: 'web5://entity/collection/pUx3mVQ1TmyN2mVYQqQ8Jg',\n            linkText: 'Running',\n            description: 'Shoes and kit built for the road',\n          },\n          {\n            entityId: 'Rr8kQyO0S1uH2nQ0mQ2AqQ',\n            entityType: 'collection',\n            entityUrl: 'web5://entity/collection/Rr8kQyO0S1uH2nQ0mQ2AqQ',\n            linkText: 'Trail',\n            description: 'Grip and protection off-road',\n          },\n        ],\n      },\n    },\n    {\n      // The shape the orchestrator emits: a section descriptor, empty link\n      // text, and a Shopify gid (which is itself a `://` url) as the entity id.\n      markdown:\n        '<!-- section:entities, semantic:items -->\\n## Curated collections by theme\\n- [](web5://entity/collection/gid://shopify/Collection/347895267466) storewide assortment spanning the full product range\\n- [](web5://entity/collection/gid://shopify/Collection/348001501322) artistic **Watercolor** candles with bright vessels',\n      expected: {\n        title: 'Curated collections by theme',\n        items: [\n          {\n            entityId: 'gid://shopify/Collection/347895267466',\n            entityType: 'collection',\n            entityUrl:\n              'web5://entity/collection/gid://shopify/Collection/347895267466',\n            description: 'storewide assortment spanning the full product range',\n          },\n          {\n            entityId: 'gid://shopify/Collection/348001501322',\n            entityType: 'collection',\n            entityUrl:\n              'web5://entity/collection/gid://shopify/Collection/348001501322',\n            // Inline emphasis survives — descriptions keep their markdown.\n            description: 'artistic **Watercolor** candles with bright vessels',\n          },\n        ],\n      },\n    },\n    {\n      // Single collection — the full-width banner shape.\n      markdown:\n        '## Winter essentials\\n\\n- [Shop winter](web5://entity/collection/aB1cD2eF3gH4iJ5kL6mN7o) Layers for the cold months',\n      expected: {\n        title: 'Winter essentials',\n        items: [\n          {\n            entityId: 'aB1cD2eF3gH4iJ5kL6mN7o',\n            entityType: 'collection',\n            entityUrl: 'web5://entity/collection/aB1cD2eF3gH4iJ5kL6mN7o',\n            linkText: 'Shop winter',\n            description: 'Layers for the cold months',\n          },\n        ],\n      },\n    },\n  ];\n\n  parse(parts: Part[], context?: ParseContext): EntityCompProps | null {\n    const entityRefs = extractEntityRefs(parts);\n\n    if (entityRefs.length === 0) {\n      context?.reportDiagnostic?.(\n        DIAGNOSTIC_TYPES.SECTION_REJECTED,\n        'entityCollection: no entity links found',\n      );\n      return null;\n    }\n\n    // Guard the pattern: anything that is not a collection means this block\n    // belongs to the generic entity section, not here.\n    if (entityRefs.some((e) => e.entityType !== COLLECTION_ENTITY_TYPE)) {\n      context?.reportDiagnostic?.(\n        DIAGNOSTIC_TYPES.SECTION_REJECTED,\n        'entityCollection: block mixes collections with other entity types',\n      );\n      return null;\n    }\n\n    const title = headingText(parts, 2) || 'Collections';\n    const description = entitySectionBodyText(parts) || undefined;\n\n    // Every entity link lives inside the list, so any top-level callout is\n    // section-level by construction — per-item callouts are nested in the list\n    // items and are picked up by extractEntityRefs instead.\n    const callout = calloutFromParts(parts);\n\n    const items: EntityItem[] = entityRefs.map((e) => ({\n      entityId: e.entityId,\n      entityType: e.entityType,\n      entityUrl: e.entityUrl,\n      linkText: e.linkText || undefined,\n      description: e.description || undefined,\n      imageUrl: e.markdownImageUrl,\n      callout: e.callout,\n    }));\n\n    return { title, description, callout, items };\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/esm/component/componentDefinitions/HeroEntitySectionDefinition.js

@@ -1,5 +1,5 @@
 import _defineProperty from "@babel/runtime/helpers/defineProperty";
-import { headingText, bodyText, firstImageSrc, parseCalloutTag, extractEntityRefs } from './parse-utils.js';
+import { headingText, headingMarkdown, bodyText, firstImageSrc, parseCalloutTag, extractEntityRefs } from './parse-utils.js';
 import { getPartsByType } from '../../parts/parts.js';
 import { DIAGNOSTIC_TYPES } from '../diagnosticTypes.js';
 
@@ -49,7 +49,7 @@ Nike offerings span performance and lifestyle lines.
 * [Nike Life Cable Knit Turtleneck Sweater](web5://entity/product/ZDvHxsa3IJA8CyGX8BNpdw)
 * [Nike x Jacquemus NRG HE Swoosh Hoodie](web5://entity/product/qH2lqINGneHWYVZzzGnXTA)`,
       expected: {
-        headline: 'Nike collections',
+        headline: '**Nike** collections',
         content: 'Nike offerings span performance and lifestyle lines.',
         image: 'web5://image/Nike+Life+collection',
         items: [{
@@ -112,7 +112,10 @@ Nike offerings span performance and lifestyle lines.
       leadingQuote = parseCalloutTag(raw).text || undefined;
     }
     return {
-      headline: headingText(parts, 1),
+      // Markdown-preserving (not headingText): the hero title now carries the
+      // bold+italic hook the ECHO callout used to own, so the FE needs the
+      // formatting, not just the plain text. See FeatureHeroEntity.tsx.
+      headline: headingMarkdown(parts, 1),
       badge: headingText(parts, 3) || undefined,
       content: bodyText(parts) || undefined,
       image: firstImageSrc(parts),

package/dist/esm/component/componentDefinitions/HeroEntitySectionDefinition.js.map

@@ -1 +1 @@
-{"version":3,"names":["headingText","bodyText","firstImageSrc","parseCalloutTag","extractEntityRefs","getPartsByType","DIAGNOSTIC_TYPES","HeroEntitySectionDefinition","constructor","_defineProperty","headline","content","items","entityId","entityType","entityUrl","linkText","markdown","expected","image","parse","parts","context","entityRefs","length","reportDiagnostic","SECTION_REJECTED","map","e","undefined","description","imageUrl","markdownImageUrl","callout","h1Index","findIndex","p","_p$meta","type","meta","level","blockquotes","leadingQuote","bq","_bq$meta","_bq$content","bqIndex","indexOf","raw","trim","text","badge"],"sources":["../../../../src/component/componentDefinitions/HeroEntitySectionDefinition.ts"],"sourcesContent":["import {\n  headingText,\n  bodyText,\n  firstImageSrc,\n  parseCalloutTag,\n  extractEntityRefs,\n} from './parse-utils';\nimport type { Part } from '../../parts/parts';\nimport { getPartsByType } from '../../parts/parts';\nimport type {\n  EntityItem,\n  HeroEntityCompProps,\n  HeroEntitySectionComponent,\n  SectionFixture,\n} from '../types';\nimport type { SectionDefinition, ParseContext } from '../section-definition';\nimport { DIAGNOSTIC_TYPES } from '../diagnosticTypes';\n\n/**\n * Hero section whose body carries one or more web5 entity links\n * (`web5://entity/...`). It mirrors the framing of {@link HeroSectionDefinition}\n * (leading callout, h1, image, intro text) but, instead of turning the links\n * into CTA buttons, surfaces them as resolvable entities.\n *\n * Registered ahead of `HeroSectionDefinition` so an entity-bearing hero is\n * claimed here first. The pattern requires at least one `link[entityType]`, and\n * `parse()` returns `null` when no entity refs are found, letting a plain hero\n * fall through to `HeroSectionDefinition`.\n */\nexport class HeroEntitySectionDefinition\n  implements SectionDefinition<HeroEntitySectionComponent>\n{\n  sectionType = 'hero-entity' as const;\n  singleInstance = true;\n  patterns = [\n    // Leading slots mirror HeroSectionDefinition: section descriptor, then the\n    // optional leading ECHO callout, then an optional h3 badge, then the h1.\n    // Callout and badge are independent; the second `html_comment?` preserves the\n    // legacy callout-before-descriptor ordering for pages saved before this change.\n    // Entity links carried as list items (the canonical shape).\n    'html_comment? > callout? > html_comment? > h3? > h1 > (image | t | link)* > list{item[1-]:link[entityType] > image? > (t | callout)*}',\n    // Entity links sitting at the top level of the hero body.\n    'html_comment? > callout? > html_comment? > h3? > h1 > (image | t)* > (link[entityType] > image? > (t | callout)*)[1-] > list?',\n  ];\n\n  defaults: HeroEntityCompProps = {\n    headline: 'Featured collection',\n    content: 'Explore the highlights from this collection.',\n    items: [\n      {\n        entityId: 'example-1',\n        entityType: 'product',\n        entityUrl: 'web5://entity/product/example-1',\n        linkText: 'Example product',\n      },\n    ],\n  };\n\n  fixtures: SectionFixture<HeroEntityCompProps>[] = [\n    {\n      markdown: `<!-- section:hero, id:hero, semantic:hero -->\n\n# **Nike** collections\n\n![Nike Life collection](web5://image/Nike+Life+collection)\nNike offerings span performance and lifestyle lines.\n\n* [Nike Throwback Future Collection](web5://entity/article/WAyuiC63OSjwpvnOyZcblQ)\n* [Nike Life Cable Knit Turtleneck Sweater](web5://entity/product/ZDvHxsa3IJA8CyGX8BNpdw)\n* [Nike x Jacquemus NRG HE Swoosh Hoodie](web5://entity/product/qH2lqINGneHWYVZzzGnXTA)`,\n      expected: {\n        headline: 'Nike collections',\n        content: 'Nike offerings span performance and lifestyle lines.',\n        image: 'web5://image/Nike+Life+collection',\n        items: [\n          {\n            entityId: 'WAyuiC63OSjwpvnOyZcblQ',\n            entityType: 'article',\n            entityUrl:\n              'web5://entity/article/WAyuiC63OSjwpvnOyZcblQ',\n            linkText: 'Nike Throwback Future Collection',\n          },\n          {\n            entityId: 'ZDvHxsa3IJA8CyGX8BNpdw',\n            entityType: 'product',\n            entityUrl:\n              'web5://entity/product/ZDvHxsa3IJA8CyGX8BNpdw',\n            linkText: 'Nike Life Cable Knit Turtleneck Sweater',\n          },\n          {\n            entityId: 'qH2lqINGneHWYVZzzGnXTA',\n            entityType: 'product',\n            entityUrl:\n              'web5://entity/product/qH2lqINGneHWYVZzzGnXTA',\n            linkText: 'Nike x Jacquemus NRG HE Swoosh Hoodie',\n          },\n        ],\n      },\n    },\n  ];\n\n  parse(parts: Part[], context?: ParseContext): HeroEntityCompProps | null {\n    const entityRefs = extractEntityRefs(parts);\n\n    if (entityRefs.length === 0) {\n      // Not an entity hero — let HeroSectionDefinition claim it.\n      context?.reportDiagnostic?.(\n        DIAGNOSTIC_TYPES.SECTION_REJECTED,\n        'hero-entity: no entity links found',\n      );\n      return null;\n    }\n\n    const items: EntityItem[] = entityRefs.map((e) => ({\n      entityId: e.entityId,\n      entityType: e.entityType,\n      entityUrl: e.entityUrl,\n      linkText: e.linkText || undefined,\n      description: e.description || undefined,\n      imageUrl: e.markdownImageUrl,\n      callout: e.callout,\n    }));\n\n    // The leading callout before the h1 — the ECHO the orchestrator emits as the\n    // hero's opening line, right after the section descriptor — is part of the\n    // hero, mirroring HeroSectionDefinition. A trailing callout falls through to a\n    // downstream callout section. (Per-item callouts inside the entity list are\n    // handled by extractEntityRefs above and are unaffected.)\n    const h1Index = parts.findIndex(\n      (p) =>\n        p.type === 'heading' && (p.meta as { level?: number })?.level === 1,\n    );\n    const blockquotes = getPartsByType<Part>(parts, 'callout');\n    let leadingQuote: string | undefined;\n\n    for (const bq of blockquotes) {\n      const bqIndex = parts.indexOf(bq);\n      if (h1Index >= 0 && bqIndex > h1Index) {\n        continue;\n      }\n      const raw = (bq.meta?.markdown as string)?.trim() || bq.content?.trim();\n      if (!raw) {\n        continue;\n      }\n      leadingQuote = parseCalloutTag(raw).text || undefined;\n    }\n\n    return {\n      headline: headingText(parts, 1),\n      badge: headingText(parts, 3) || undefined,\n      content: bodyText(parts) || undefined,\n      image: firstImageSrc(parts),\n      leadingQuote,\n      items,\n    };\n  }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["headingText","headingMarkdown","bodyText","firstImageSrc","parseCalloutTag","extractEntityRefs","getPartsByType","DIAGNOSTIC_TYPES","HeroEntitySectionDefinition","constructor","_defineProperty","headline","content","items","entityId","entityType","entityUrl","linkText","markdown","expected","image","parse","parts","context","entityRefs","length","reportDiagnostic","SECTION_REJECTED","map","e","undefined","description","imageUrl","markdownImageUrl","callout","h1Index","findIndex","p","_p$meta","type","meta","level","blockquotes","leadingQuote","bq","_bq$meta","_bq$content","bqIndex","indexOf","raw","trim","text","badge"],"sources":["../../../../src/component/componentDefinitions/HeroEntitySectionDefinition.ts"],"sourcesContent":["import {\n  headingText,\n  headingMarkdown,\n  bodyText,\n  firstImageSrc,\n  parseCalloutTag,\n  extractEntityRefs,\n} from './parse-utils';\nimport type { Part } from '../../parts/parts';\nimport { getPartsByType } from '../../parts/parts';\nimport type {\n  EntityItem,\n  HeroEntityCompProps,\n  HeroEntitySectionComponent,\n  SectionFixture,\n} from '../types';\nimport type { SectionDefinition, ParseContext } from '../section-definition';\nimport { DIAGNOSTIC_TYPES } from '../diagnosticTypes';\n\n/**\n * Hero section whose body carries one or more web5 entity links\n * (`web5://entity/...`). It mirrors the framing of {@link HeroSectionDefinition}\n * (leading callout, h1, image, intro text) but, instead of turning the links\n * into CTA buttons, surfaces them as resolvable entities.\n *\n * Registered ahead of `HeroSectionDefinition` so an entity-bearing hero is\n * claimed here first. The pattern requires at least one `link[entityType]`, and\n * `parse()` returns `null` when no entity refs are found, letting a plain hero\n * fall through to `HeroSectionDefinition`.\n */\nexport class HeroEntitySectionDefinition\n  implements SectionDefinition<HeroEntitySectionComponent>\n{\n  sectionType = 'hero-entity' as const;\n  singleInstance = true;\n  patterns = [\n    // Leading slots mirror HeroSectionDefinition: section descriptor, then the\n    // optional leading ECHO callout, then an optional h3 badge, then the h1.\n    // Callout and badge are independent; the second `html_comment?` preserves the\n    // legacy callout-before-descriptor ordering for pages saved before this change.\n    // Entity links carried as list items (the canonical shape).\n    'html_comment? > callout? > html_comment? > h3? > h1 > (image | t | link)* > list{item[1-]:link[entityType] > image? > (t | callout)*}',\n    // Entity links sitting at the top level of the hero body.\n    'html_comment? > callout? > html_comment? > h3? > h1 > (image | t)* > (link[entityType] > image? > (t | callout)*)[1-] > list?',\n  ];\n\n  defaults: HeroEntityCompProps = {\n    headline: 'Featured collection',\n    content: 'Explore the highlights from this collection.',\n    items: [\n      {\n        entityId: 'example-1',\n        entityType: 'product',\n        entityUrl: 'web5://entity/product/example-1',\n        linkText: 'Example product',\n      },\n    ],\n  };\n\n  fixtures: SectionFixture<HeroEntityCompProps>[] = [\n    {\n      markdown: `<!-- section:hero, id:hero, semantic:hero -->\n\n# **Nike** collections\n\n![Nike Life collection](web5://image/Nike+Life+collection)\nNike offerings span performance and lifestyle lines.\n\n* [Nike Throwback Future Collection](web5://entity/article/WAyuiC63OSjwpvnOyZcblQ)\n* [Nike Life Cable Knit Turtleneck Sweater](web5://entity/product/ZDvHxsa3IJA8CyGX8BNpdw)\n* [Nike x Jacquemus NRG HE Swoosh Hoodie](web5://entity/product/qH2lqINGneHWYVZzzGnXTA)`,\n      expected: {\n        headline: '**Nike** collections',\n        content: 'Nike offerings span performance and lifestyle lines.',\n        image: 'web5://image/Nike+Life+collection',\n        items: [\n          {\n            entityId: 'WAyuiC63OSjwpvnOyZcblQ',\n            entityType: 'article',\n            entityUrl:\n              'web5://entity/article/WAyuiC63OSjwpvnOyZcblQ',\n            linkText: 'Nike Throwback Future Collection',\n          },\n          {\n            entityId: 'ZDvHxsa3IJA8CyGX8BNpdw',\n            entityType: 'product',\n            entityUrl:\n              'web5://entity/product/ZDvHxsa3IJA8CyGX8BNpdw',\n            linkText: 'Nike Life Cable Knit Turtleneck Sweater',\n          },\n          {\n            entityId: 'qH2lqINGneHWYVZzzGnXTA',\n            entityType: 'product',\n            entityUrl:\n              'web5://entity/product/qH2lqINGneHWYVZzzGnXTA',\n            linkText: 'Nike x Jacquemus NRG HE Swoosh Hoodie',\n          },\n        ],\n      },\n    },\n  ];\n\n  parse(parts: Part[], context?: ParseContext): HeroEntityCompProps | null {\n    const entityRefs = extractEntityRefs(parts);\n\n    if (entityRefs.length === 0) {\n      // Not an entity hero — let HeroSectionDefinition claim it.\n      context?.reportDiagnostic?.(\n        DIAGNOSTIC_TYPES.SECTION_REJECTED,\n        'hero-entity: no entity links found',\n      );\n      return null;\n    }\n\n    const items: EntityItem[] = entityRefs.map((e) => ({\n      entityId: e.entityId,\n      entityType: e.entityType,\n      entityUrl: e.entityUrl,\n      linkText: e.linkText || undefined,\n      description: e.description || undefined,\n      imageUrl: e.markdownImageUrl,\n      callout: e.callout,\n    }));\n\n    // The leading callout before the h1 — the ECHO the orchestrator emits as the\n    // hero's opening line, right after the section descriptor — is part of the\n    // hero, mirroring HeroSectionDefinition. A trailing callout falls through to a\n    // downstream callout section. (Per-item callouts inside the entity list are\n    // handled by extractEntityRefs above and are unaffected.)\n    const h1Index = parts.findIndex(\n      (p) =>\n        p.type === 'heading' && (p.meta as { level?: number })?.level === 1,\n    );\n    const blockquotes = getPartsByType<Part>(parts, 'callout');\n    let leadingQuote: string | undefined;\n\n    for (const bq of blockquotes) {\n      const bqIndex = parts.indexOf(bq);\n      if (h1Index >= 0 && bqIndex > h1Index) {\n        continue;\n      }\n      const raw = (bq.meta?.markdown as string)?.trim() || bq.content?.trim();\n      if (!raw) {\n        continue;\n      }\n      leadingQuote = parseCalloutTag(raw).text || undefined;\n    }\n\n    return {\n      // Markdown-preserving (not headingText): the hero title now carries the\n      // bold+italic hook the ECHO callout used to own, so the FE needs the\n      // formatting, not just the plain text. See FeatureHeroEntity.tsx.\n      headline: headingMarkdown(parts, 1),\n      badge: headingText(parts, 3) || undefined,\n      content: bodyText(parts) || undefined,\n      image: firstImageSrc(parts),\n      leadingQuote,\n      items,\n    };\n  }\n}\n"],"mappings":"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","ignoreList":[]}