@wix/web5-core 1.57.2 → 1.59.0

package/dist/cjs/client/applyThemeOverrides.js

@@ -0,0 +1,89 @@
+"use strict";
+
+exports.__esModule = true;
+exports.THEME_OVERRIDE_TOKENS = void 0;
+exports.applyThemeOverrides = applyThemeOverrides;
+var _hostScope = require("../hostScope");
+/**
+ * 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.
+ */
+
+/** 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).
+ */
+const THEME_OVERRIDE_TOKENS = exports.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';
+function applyThemeOverrides(overrides) {
+  if (typeof document === 'undefined') return;
+  const existing = document.head.querySelector(`style[${MARKER_ATTR}]`);
+  const entries = Object.entries(overrides ?? {}).filter(([key]) => {
+    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(`${_hostScope.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/cjs/client/applyThemeOverrides.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_hostScope","require","THEME_OVERRIDE_TOKENS","exports","Set","KEY_PATTERN","MARKER_ATTR","applyThemeOverrides","overrides","document","existing","head","querySelector","entries","Object","filter","key","wellFormed","test","console","warn","length","remove","style","createElement","setAttribute","appendChild","sheet","insertRule","WEB5_SCOPE","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":";;;;;AAwBA,IAAAA,UAAA,GAAAC,OAAA;AAxBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;;AAGA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMC,qBAA0C,GAAAC,OAAA,CAAAD,qBAAA,GAAG,IAAIE,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;AAExC,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,CAAC,CAAC,CAACC,GAAG,CAAC,KAAK;IAChE,MAAMC,UAAU,GAAGZ,WAAW,CAACa,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,IAAIJ,OAAO,CAACQ,MAAM,KAAK,CAAC,EAAE;IACxBX,QAAQ,YAARA,QAAQ,CAAEY,MAAM,CAAC,CAAC;IAClB;EACF;EAEA,MAAMC,KAAK,GAAGd,QAAQ,CAACe,aAAa,CAAC,OAAO,CAAC;EAC7CD,KAAK,CAACE,YAAY,CAACnB,WAAW,EAAE,EAAE,CAAC;EACnCG,QAAQ,CAACE,IAAI,CAACe,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,GAAGC,qBAAU,KAAK,EAAE,CAAC,CAAC;EACvC,MAAMC,IAAI,GAAGH,KAAK,CAACI,QAAQ,CAAC,CAAC,CAAiB;EAC9C,KAAK,MAAM,CAACf,GAAG,EAAEgB,KAAK,CAAC,IAAInB,OAAO,EAAE;IAClC,IAAI;MACFiB,IAAI,CAACP,KAAK,CAACU,WAAW,CAACjB,GAAG,EAAEgB,KAAK,CAAC;IACpC,CAAC,CAAC,MAAM;MACN;MACA;IAAA;EAEJ;EACA;EACA;EACAtB,QAAQ,YAARA,QAAQ,CAAEY,MAAM,CAAC,CAAC;AACpB","ignoreList":[]}

package/dist/cjs/client/clientBundleUrl.js

@@ -0,0 +1,83 @@
+"use strict";
+
+exports.__esModule = true;
+exports.TEMPLATES_MANIFEST_URL = exports.TEMPLATES_CDN_BASE = void 0;
+exports.getTemplateOverride = getTemplateOverride;
+exports.isTemplatePickerRequested = isTemplatePickerRequested;
+exports.isValidTemplateId = isValidTemplateId;
+exports.resolveClientBundleUrl = resolveClientBundleUrl;
+/**
+ * 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`.
+ */
+const TEMPLATES_CDN_BASE = exports.TEMPLATES_CDN_BASE = `${CLIENT_BUNDLE_CDN}/templates`;
+const TEMPLATES_MANIFEST_URL = exports.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]+)*$/;
+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`.
+ */
+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? */
+function isTemplatePickerRequested(search) {
+  return new URLSearchParams(search).get('web5TemplatePicker') === '1';
+}
+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/cjs/client/clientBundleUrl.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["CLIENT_BUNDLE_CDN","CLIENT_BUNDLE_FILENAME","TEMPLATES_CDN_BASE","exports","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;AACO,MAAMC,kBAAkB,GAAAC,OAAA,CAAAD,kBAAA,GAAG,GAAGF,iBAAiB,YAAY;AAC3D,MAAMI,sBAAsB,GAAAD,OAAA,CAAAC,sBAAA,GAAG,GAAGF,kBAAkB,gBAAgB;;AAE3E;AACA;AACA;AACA;AACA;AACA;AACA,MAAMG,mBAAmB,GAAG,0BAA0B;AAE/C,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;AACO,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;AACO,SAASK,yBAAyBA,CAACN,MAAc,EAAW;EACjE,OAAO,IAAIE,eAAe,CAACF,MAAM,CAAC,CAACG,GAAG,CAAC,oBAAoB,CAAC,KAAK,GAAG;AACtE;AAEO,SAASI,sBAAsBA,CACpCC,IAAY,EACZC,UAA0B,EAClB;EACR,IAAIA,UAAU,EAAE;IACd,IAAIf,mBAAmB,CAACI,IAAI,CAACW,UAAU,CAAC,EAAE;MACxC,OAAO,GAAGpB,iBAAiB,cAAcoB,UAAU,eAAenB,sBAAsB,EAAE;IAC5F;IACAc,OAAO,CAACC,IAAI,CACV,8CAA8CI,UAAU,0CAC1D,CAAC;EACH;EACA,OAAO,GAAGpB,iBAAiB,IAAImB,IAAI,WAAWlB,sBAAsB,EAAE;AACxE","ignoreList":[]}

package/dist/cjs/client/mergeClientConfig.js

@@ -0,0 +1,59 @@
+"use strict";
+
+exports.__esModule = true;
+exports.mergeClientConfig = mergeClientConfig;
+/**
+ * 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);
+}
+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/cjs/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;AAEO,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/cjs/component/componentDefinitions/EntityCollectionSectionDefinition.js

@@ -0,0 +1,159 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+exports.__esModule = true;
+exports.EntityCollectionSectionDefinition = void 0;
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _parseUtils = require("./parse-utils");
+var _diagnosticTypes = require("../diagnosticTypes");
+/**
+ * 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`.
+ */
+class EntityCollectionSectionDefinition {
+  constructor() {
+    (0, _defineProperty2.default)(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.
+     */
+    (0, _defineProperty2.default)(this, "patterns", ['html_comment* > h2 > (html_comment | t | callout)* > list{item[1-]:link[entityType="collection"] > image? > (t | callout)*}']);
+    (0, _defineProperty2.default)(this, "defaults", {
+      title: 'Collections',
+      items: [{
+        entityId: 'example-1',
+        entityType: COLLECTION_ENTITY_TYPE,
+        entityUrl: 'web5://entity/collection/example-1',
+        linkText: 'Example collection'
+      }]
+    });
+    (0, _defineProperty2.default)(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 = (0, _parseUtils.extractEntityRefs)(parts);
+    if (entityRefs.length === 0) {
+      context == null || context.reportDiagnostic == null || context.reportDiagnostic(_diagnosticTypes.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(_diagnosticTypes.DIAGNOSTIC_TYPES.SECTION_REJECTED, 'entityCollection: block mixes collections with other entity types');
+      return null;
+    }
+    const title = (0, _parseUtils.headingText)(parts, 2) || 'Collections';
+    const description = (0, _parseUtils.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 = (0, _parseUtils.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
+    };
+  }
+}
+exports.EntityCollectionSectionDefinition = EntityCollectionSectionDefinition;
+//# sourceMappingURL=EntityCollectionSectionDefinition.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_parseUtils","require","_diagnosticTypes","COLLECTION_ENTITY_TYPE","EntityCollectionSectionDefinition","constructor","_defineProperty2","default","title","items","entityId","entityType","entityUrl","linkText","markdown","expected","description","parse","parts","context","entityRefs","extractEntityRefs","length","reportDiagnostic","DIAGNOSTIC_TYPES","SECTION_REJECTED","some","e","headingText","entitySectionBodyText","undefined","callout","calloutFromParts","map","imageUrl","markdownImageUrl","exports"],"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/cjs/component/componentDefinitions/HeroEntitySectionDefinition.js

@@ -53,7 +53,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: [{
@@ -116,7 +116,10 @@ Nike offerings span performance and lifestyle lines.
       leadingQuote = (0, _parseUtils.parseCalloutTag)(raw).text || undefined;
     }
     return {
-      headline: (0, _parseUtils.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: (0, _parseUtils.headingMarkdown)(parts, 1),
       badge: (0, _parseUtils.headingText)(parts, 3) || undefined,
       content: (0, _parseUtils.bodyText)(parts) || undefined,
       image: (0, _parseUtils.firstImageSrc)(parts),

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

@@ -1 +1 @@
-{"version":3,"names":["_parseUtils","require","_parts","_diagnosticTypes","HeroEntitySectionDefinition","constructor","_defineProperty2","default","headline","content","items","entityId","entityType","entityUrl","linkText","markdown","expected","image","parse","parts","context","entityRefs","extractEntityRefs","length","reportDiagnostic","DIAGNOSTIC_TYPES","SECTION_REJECTED","map","e","undefined","description","imageUrl","markdownImageUrl","callout","h1Index","findIndex","p","_p$meta","type","meta","level","blockquotes","getPartsByType","leadingQuote","bq","_bq$meta","_bq$content","bqIndex","indexOf","raw","trim","parseCalloutTag","text","headingText","badge","bodyText","firstImageSrc","exports"],"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":["_parseUtils","require","_parts","_diagnosticTypes","HeroEntitySectionDefinition","constructor","_defineProperty2","default","headline","content","items","entityId","entityType","entityUrl","linkText","markdown","expected","image","parse","parts","context","entityRefs","extractEntityRefs","length","reportDiagnostic","DIAGNOSTIC_TYPES","SECTION_REJECTED","map","e","undefined","description","imageUrl","markdownImageUrl","callout","h1Index","findIndex","p","_p$meta","type","meta","level","blockquotes","getPartsByType","leadingQuote","bq","_bq$meta","_bq$content","bqIndex","indexOf","raw","trim","parseCalloutTag","text","headingMarkdown","badge","headingText","bodyText","firstImageSrc","exports"],"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":[]}

package/dist/cjs/component/componentDefinitions/HeroSectionDefinition.js

@@ -203,7 +203,10 @@ Get started today with our amazing features.
       leadingQuote = (0, _parseUtils.parseCalloutTag)(raw).text || undefined;
     }
     return {
-      headline: (0, _parseUtils.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 FeatureComparisonHero.tsx.
+      headline: (0, _parseUtils.headingMarkdown)(parts, 1),
       badge: (0, _parseUtils.headingText)(parts, 3) || undefined,
       content: (0, _parseUtils.bodyText)(parts) || undefined,
       buttons: buttons.length > 0 ? buttons : undefined,